Zum Hauptinhalt springen
GET
/
media-bridge
/
v1
/
{appId}
/
properties
/
{objectType}
/
{propertyName}
Die Details für eine Eigenschaft abrufen
curl --request GET \
  --url 'https://api.hubapi.com/media-bridge/v1/{appId}/properties/{objectType}/{propertyName}?hapikey='
{
  "allowedObjectTypes": [
    {
      "innerId": 123,
      "metaTypeId": 123
    }
  ],
  "calculated": true,
  "canArchive": true,
  "canRestore": true,
  "createdAt": 123,
  "createdUserId": 123,
  "currencyPropertyName": "<string>",
  "dataSensitivity": "high",
  "dateDisplayHint": "absolute",
  "deleted": true,
  "description": "<string>",
  "displayMode": "all_unique_versions",
  "displayOrder": 123,
  "enforceMultivalueUniqueness": true,
  "externalOptions": true,
  "externalOptionsReferenceType": "<string>",
  "favorited": true,
  "favoritedOrder": 123,
  "fieldType": "<string>",
  "formField": true,
  "fromUserId": 123,
  "groupName": "<string>",
  "hasUniqueValue": true,
  "hidden": false,
  "hubspotDefined": true,
  "isCustomizedDefault": true,
  "isMultiValued": true,
  "isPartial": true,
  "label": "<string>",
  "mutableDefinitionNotDeletable": true,
  "name": "<string>",
  "numberDisplayHint": "currency",
  "optionSortStrategy": "ALPHABETICAL",
  "options": [
    {
      "description": "<string>",
      "displayOrder": 123,
      "doubleData": 123,
      "hidden": true,
      "label": "<string>",
      "readOnly": true,
      "value": "<string>"
    }
  ],
  "optionsAreMutable": true,
  "owningAppId": 123,
  "portalId": 123,
  "readOnlyDefinition": true,
  "readOnlyValue": true,
  "referencedObjectType": "ABANDONED_CART",
  "searchTextAnalysisMode": "NONE",
  "searchableInGlobalSearch": true,
  "sensitiveDataCategories": [
    "<string>"
  ],
  "showCurrencySymbol": true,
  "textDisplayHint": "domain_name",
  "type": "bool",
  "updatedAt": 123
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

hapikey
string
query
erforderlich

Pfadparameter

appId
integer<int32>
erforderlich

Die appId für die Media-Bridge-App. In Ihrem Entwickler-Account können mehrere Apps vorhanden sein, die die Media Bridge verwenden.

objectType
string
erforderlich

Der Objekttyp für die Eigenschaft.

propertyName
string
erforderlich

Der Name der Eigenschaft, für die die Details abgerufen werden sollen.

Abfrageparameter

archived
boolean
Standard:false

Ob nur Ergebnisse zurückgegeben werden sollen, die archiviert wurden.

properties
string

Grenzen Sie die Antwort ein, damit nur die angegebenen Eigenschaften enthalten sind.

Antwort

successful operation

A HubSpot property

allowedObjectTypes
object[]
erforderlich

Objekttypen, die zur Verwendung dieser Eigenschaft berechtigt sind.

calculated
boolean
erforderlich

Ob es sich bei der Eigenschaft um ein berechnetes Feld handelt.

canArchive
boolean
erforderlich
canRestore
boolean
erforderlich
createdAt
integer<int64>
erforderlich

Der Zeitstempel, wann die Eigenschaft erstellt wurde (Format ISO 8601).

createdUserId
integer<int64>
erforderlich

Die ID des Benutzers, der die Eigenschaft erstellt hat.

currencyPropertyName
string
erforderlich

Der Name er zugehörigen Währungseigenschaft.

dataSensitivity
enum<string>
erforderlich

Gibt die Vertraulichkeitsstufe der Eigenschaft an, z. B. „non_sensitive“, „sensitive“ oder „highly_sensitive“.

Verfügbare Optionen:
high,
none,
standard
dateDisplayHint
enum<string>
erforderlich
Verfügbare Optionen:
absolute,
absolute_with_relative,
time_since,
time_until
deleted
boolean
erforderlich

Ob die Eigenschaft gelöscht wurde.

description
string
erforderlich

Eine Übersicht über den Zweck der Eigenschaft.

displayMode
enum<string>
erforderlich

Der Modus, in dem die Eigenschaft angezeigt wird. Kann „current_value“ oder „all_unique_versions“ sein.

Verfügbare Optionen:
all_unique_versions,
current_value
displayOrder
integer<int32>
erforderlich

Die Position des Elements in Bezug auf andere Elemente der Liste.

enforceMultivalueUniqueness
boolean
erforderlich
externalOptions
boolean
erforderlich

Gilt nur für Eigenschaften vom Typ „Aufzählung“. Muss in Verbindung mit einem „referencedObjectType“ von „OWNER“ auf „true“ (wahr) festgelegt werden. Ist andernfalls „false“ (falsch).

externalOptionsReferenceType
string
erforderlich

Wenn „externalOptions“ auf „true“ (wahr) festgelegt ist, werden die Optionswerte der Eigenschaft aus anderen Systemen abgerufen (z. B. „OWNER“ für die Eigenschaft „hubspot_owner_id“).

favorited
boolean
erforderlich

Veraltet. Ob die Eigenschaft als Favorit markiert ist.

favoritedOrder
integer<int32>
erforderlich

Veraltet. Die Position in der Reihenfolge bei Kennzeichnung als Favorit.

fieldType
string
erforderlich

Legt fest, wie die Eigenschaft in der HubSpot-UI oder in einem Formular angezeigt wird. Weitere Informationen in der Anleitung zur Eigenschaften-API.

formField
boolean
erforderlich

Ob die Eigenschaft in Formularen verwendet werden kann.

fromUserId
integer<int64>
erforderlich

Die ID des Benutzers, der die Eigenschaft zuletzt aktualisiert hat.

groupName
string
erforderlich

Der Name der Gruppe, der die Eigenschaft zugeordnet ist.

hasUniqueValue
boolean
erforderlich

Ob es sich bei der Eigenschaft um eine „Eindeutige ID“-Eigenschaft handelt.

hidden
boolean
erforderlich

Ob die Eigenschaft aus der HubSpot-UI ausgeblendet wird oder nicht. Empfohlen wird, diese Option bei benutzerdefinierten Eigenschaften auf „false“ (falsch) zu setzen.

Beispiel:

false

hubspotDefined
boolean
erforderlich

Ein boolescher Wert, der für Standardeigenschaften von HubSpot auf „true“ (wahr) festgelegt ist.

isCustomizedDefault
boolean
erforderlich

Für Standardeigenschaften; gibt an, ob die Eingeschaft angepasst wurde. Entspricht dem Feld „isCustomizedDefault“.

isMultiValued
boolean
erforderlich

Ob die Eigenschaften mehrere Werte enthalten kann.

isPartial
boolean
erforderlich

Für Standardeigenschaften; gibt an, ob die Eingeschaft angepasst wurde. Entspricht dem Feld „isCustomizedDefault“.

label
string
erforderlich

Das Anzeigelabel für die Eigenschaft.

mutableDefinitionNotDeletable
boolean
erforderlich

Ob die Eigenschaftsdefinition angepasst, jedoch nicht gelöscht werden kann.

name
string
erforderlich

Der interne Name der Eigenschaft.

numberDisplayHint
enum<string>
erforderlich

Hinweis, wie eine Zahleneigenschaft in der HubSpot-UI angezeigt und validiert wird. Kann „unformatted“, „formatted“, „currency“, „percentage“, „duration“ oder „probability“ sein.

Verfügbare Optionen:
currency,
duration,
formatted,
percentage,
probability,
unformatted
optionSortStrategy
enum<string>
erforderlich

Gibt an, wie Eigenschaftsoptionen sortiert werden. Kann entweder „DISPLAY_ORDER“ zum Verschieben in das Feld „displayOrder“ oder „ALPHABETICAL“ sein.

Verfügbare Optionen:
ALPHABETICAL,
DISPLAY_ORDER
options
object[]
erforderlich

Eine Liste der gültigen Optionen für die Eigenschaft. Pflichtfeld bei Aufzählungseigenschaften.

optionsAreMutable
boolean
erforderlich

Ob Optionen nach der Erstellung geändert werden können.

owningAppId
integer<int64>
erforderlich
portalId
integer<int64>
erforderlich

Die ID des HubSpot-Accounts, in dem die Eigenschaft definiert ist.

readOnlyDefinition
boolean
erforderlich

Ob die Beschreibung der Eigenschaft schreibgeschützt ist.

readOnlyValue
boolean
erforderlich

Gibt an, ob der Wert der Eigenschaft schreibgeschützt ist.

referencedObjectType
enum<string>
erforderlich

Veraltet. Verwenden Sie stattdessen „externalOptionsReferenceType“.

Verfügbare Optionen:
ABANDONED_CART,
ACCEPTANCE_TEST,
AD,
AD_ACCOUNT,
AD_CAMPAIGN,
AD_GROUP,
AI_FORECAST,
ALL_PAGES,
APPROVAL,
APPROVAL_STEP,
ATTRIBUTION,
AUDIENCE,
AUTOMATION_JOURNEY,
AUTOMATION_PLATFORM_FLOW,
AUTOMATION_PLATFORM_FLOW_ACTION,
BET_ALERT,
BET_DELIVERABLE_SERVICE,
BLOG_LISTING_PAGE,
BLOG_POST,
CALL,
CAMPAIGN,
CAMPAIGN_BUDGET_ITEM,
CAMPAIGN_SPEND_ITEM,
CAMPAIGN_STEP,
CAMPAIGN_TEMPLATE,
CAMPAIGN_TEMPLATE_STEP,
CART,
CASE_STUDY,
CHATFLOW,
CLIP,
CMS_URL,
COMBO_EVENT_CONFIGURATION,
COMMERCE_PAYMENT,
COMMUNICATION,
COMPANY,
CONTACT,
CONTACT_CREATE_ATTRIBUTION,
CONTENT,
CONTENT_AUDIT,
CONTENT_AUDIT_PAGE,
CONVERSATION,
CONVERSATION_INBOX,
CONVERSATION_SESSION,
CRM_OBJECTS_DUMMY_TYPE,
CRM_PIPELINES_DUMMY_TYPE,
CTA,
CTA_VARIANT,
DATA_PRIVACY_CONSENT,
DATA_SYNC_STATE,
DEAL,
DEAL_CREATE_ATTRIBUTION,
DEAL_REGISTRATION,
DEAL_SPLIT,
DISCOUNT,
DISCOUNT_CODE,
DISCOUNT_TEMPLATE,
EMAIL,
ENGAGEMENT,
EXPORT,
EXTERNAL_WEB_URL,
FEE,
FEEDBACK_SUBMISSION,
FEEDBACK_SURVEY,
FILE_MANAGER_FILE,
FILE_MANAGER_FOLDER,
FOLDER,
FORECAST,
FORM,
FORM_SUBMISSION_INBOUNDDB,
GOAL_TARGET,
GOAL_TARGET_GROUP,
GOAL_TEMPLATE,
GSC_PROPERTY,
HUB,
IMPORT,
INVOICE,
KEYWORD,
KNOWLEDGE_ARTICLE,
LANDING_PAGE,
LEAD,
LINE_ITEM,
MARKETING_CALENDAR,
MARKETING_CAMPAIGN_UTM,
MARKETING_EMAIL,
MARKETING_EVENT,
MARKETING_EVENT_ATTENDANCE,
MARKETING_SMS,
MEDIA_BRIDGE,
MEETING_EVENT,
MIC,
NOTE,
OBJECT_LIST,
ORDER,
OWNER,
PARTNER_ACCOUNT,
PARTNER_CLIENT,
PARTNER_CLIENT_REVENUE,
PARTNER_SERVICE,
PAYMENT_LINK,
PAYMENT_SCHEDULE,
PAYMENT_SCHEDULE_INSTALLMENT,
PERMISSIONS_TESTING,
PLAYBOOK,
PLAYBOOK_QUESTION,
PLAYBOOK_SUBMISSION,
PLAYBOOK_SUBMISSION_ANSWER,
PLAYLIST,
PLAYLIST_FOLDER,
PODCAST_EPISODE,
PORTAL,
PORTAL_OBJECT_SYNC_MESSAGE,
POSTAL_MAIL,
PRIVACY_SCANNER_COOKIE,
PRODUCT,
PRODUCT_OR_FOLDER,
PROPERTY_INFO,
PROSPECTING_AGENT_CONTACT_ASSIGNMENT,
PUBLISHING_TASK,
QUARANTINED_SUBMISSION,
QUOTA,
QUOTE,
QUOTE_FIELD,
QUOTE_MODULE,
QUOTE_MODULE_FIELD,
QUOTE_TEMPLATE,
RESTORABLE_CRM_OBJECT,
ROSTER,
ROSTER_MEMBER,
SALES_DOCUMENT,
SALES_TASK,
SALES_WORKLOAD,
SALESFORCE_SYNC_ERROR,
SCHEDULING_PAGE,
SCHEMAS_BACKEND_TEST,
SCORE_CONFIGURATION,
SEQUENCE,
SEQUENCE_ENROLLMENT,
SEQUENCE_STEP,
SEQUENCE_STEP_ENROLLMENT,
SERVICE,
SITE_PAGE,
SNIPPET,
SOCIAL_BROADCAST,
SOCIAL_CHANNEL,
SOCIAL_POST,
SOCIAL_PROFILE,
SOX_PROTECTED_DUMMY_TYPE,
SOX_PROTECTED_TEST_TYPE,
SUBMISSION_TAG,
SUBSCRIPTION,
TASK,
TASK_TEMPLATE,
TAX,
TEMPLATE,
TICKET,
UNKNOWN,
UNSUBSCRIBE,
USER,
VIEW,
VIEW_BLOCK,
WEB_INTERACTIVE
searchTextAnalysisMode
enum<string>
erforderlich
Verfügbare Optionen:
NONE,
NOT_ANALYZED_TEXT

Ob die Eigenschaft global durchsuchbar ist.

sensitiveDataCategories
string[]
erforderlich

Führt den in der Eigenschaft enthaltenen Typ vertraulicher Daten (z. B. „HIPAA“) auf, wenn „sensitiveData“ auf „true“ (wahr) festgelegt ist.

showCurrencySymbol
boolean
erforderlich

Ob das Währungssymbol in der HubSpot-UI anzeigt wird.

textDisplayHint
enum<string>
erforderlich

Hinweis, wie der Text in der HubSpot-UI angezeigt und validiert wird. Kann „unformatted_single_line“, „multi_line“, „email“, „phone_number“, „domain_name“, „ip_address“, „physical_address“ oder „postal_code“ sein.

Verfügbare Optionen:
domain_name,
email,
ip_address,
multi_line,
phone_number,
physical_address,
postal_code,
unformatted_single_line
type
enum<string>
erforderlich

Der Datentyp der Eigenschaft, z. B. Zeichenfolge oder Zahl.

Verfügbare Optionen:
bool,
currency_number,
date,
datetime,
enumeration,
json,
number,
object_coordinates,
phone_number,
string
updatedAt
integer<int64>
erforderlich

Der Zeitstempel, wann die Eigenschaft zuletzt aktualisiert wurde (Format ISO 8601).

Last modified on December 10, 2025