Ein Marketingevent erstellen

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.

Marketing Hub -Kostenlos

Sales Hub -Kostenlos

Service Hub -Kostenlos

Content Hub -Starter

Erforderliche Bereiche

Diese API erfordert einen der folgenden Bereiche:

crm.objects.marketing_events.write

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

customProperties

object[]

required

Eine PropertyValues-Liste. Es kann sich um beliebige Eigenschaftsnamen und -werte handeln, die jedoch bereits in der Definition des MarketingEvent-Objekts im HubSpot-Account enthalten sein müssen. Ist dies nicht der Fall, werden sie herausgefiltert und nicht festgelegt. Um dies auszuschließen, müssen Sie für Ihre App eine neue PropertyGroup für das MarketingEvent-Objekt im HubSpot-Account sowie die benutzerdefinierte Eigenschaft erstellen, die Sie in diesem HubSpot-Account nachverfolgen möchten. Erstellen Sie keine neuen Standardeigenschaften für das MarketingEvent-Objekt, da dies auf alle HubSpot-Accounts angewendet wird.

Anzeigen untergeordnete attribute

customProperties.dataSensitivity

enum<string>

required

The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".

Verfügbare Optionen:

high,

none,

standard

customProperties.isEncrypted

boolean

required

Whether the property value is encrypted.

customProperties.isLargeValue

boolean

required

Gibt an, ob der Eigenschaftswert als großer Wert im Speicher gespeichert wird.

customProperties.name

string

required

Name der benutzerdefinierten Eigenschaft

customProperties.persistenceTimestamp

integer<int64>

required

Der Zeitstempel, der angibt, wann der geschriebene Wert im Speicher persistent gespeichert wird.

customProperties.requestId

string

required

A unique ID associated with this request.

customProperties.selectedByUser

boolean

required

Whether the value was selected by a user.

customProperties.selectedByUserTimestamp

integer<int64>

required

The timestamp when the value was selected by a user, if applicable.

customProperties.source

enum<string>

required

The origin of the property value, such as "IMPORT" or "API".

Verfügbare Optionen:

ACADEMY,

ACCEPTANCE_TEST,

ACTIVITY_AUTO_ASSOCIATE,

ADS,

AI_GROUP,

ANALYTICS,

API,

APPROVALS,

ASSISTS,

ASSOCIATIONS,

AUTO_ASSOCIATE_BY_DOMAIN,

AUTOMATION_JOURNEY,

AUTOMATION_PLATFORM,

AVATARS_SERVICE,

BATCH_UPDATE,

BCC_TO_CRM,

BEHAVIORAL_EVENTS,

BET_ASSIGNMENT,

BET_CRM_CONNECTOR,

BIDEN,

BILLING,

BOT,

CALCULATED,

CENTRAL_EXCHANGE_RATES,

CHATSPOT,

CLONE_OBJECTS,

COMMUNICATOR,

COMPANIES,

COMPANY_FAMILIES,

COMPANY_INSIGHTS,

CONTACTS,

CONTACTS_WEB,

CONTENT_MEMBERSHIP,

CONVERSATIONAL_ENRICHMENT,

CONVERSATIONS,

CRM_PROCESSES_PLATFORM,

CRM_UI,

CRM_UI_BULK_ACTION,

CUSTOMER_AGENT,

DATA_ENRICHMENT,

DATASET,

DEALS,

DEFAULT,

DELETE_OBJECTS,

EMAIL,

EMAIL_INBOX_IMPORT,

EMAIL_INTEGRATION,

ENGAGEMENTS,

EXTENSION,

FILE_MANAGER,

FLYWHEEL_PRODUCT_DATA_SYNC,

FORECASTING,

FORM,

FORWARD_TO_CRM,

GMAIL_INTEGRATION,

GOALS,

HEISENBERG,

HELP_DESK,

HELP_DESK_AI,

IMPORT,

INTEGRATION,

INTEGRATIONS_PLATFORM,

INTEGRATIONS_SYNC,

INTENT,

INTERNAL_PROCESSING,

LEADIN,

LEGAL_BASIS_REMEDIATION,

MARKET_SOURCING,

MARKETPLACE,

MEETINGS,

MERGE_COMPANIES,

MERGE_CONTACTS,

MERGE_OBJECTS,

MERGE_REVERT_OBJECTS,

MICROAPPS,

MIGRATION,

MOBILE_ANDROID,

MOBILE_IOS,

PAYMENTS,

PIPELINE_SETTINGS,

PLAYBOOKS,

PORTAL_OBJECT_SYNC,

PORTAL_USER_ASSOCIATOR,

PRESENTATIONS,

PRIMARY_AUTOMATION,

PROPERTY_DEFAULT_VALUE,

PROPERTY_RESTORE,

PROPERTY_SETTINGS,

PROSPECTING_AGENT,

QUOTAS,

QUOTES,

RECYCLING_BIN,

RESTORE_OBJECTS,

SALES,

SALES_MESSAGES,

SALESFORCE,

SEQUENCES,

SETTINGS,

SIDEKICK,

SIGNALS,

SLACK_INTEGRATION,

SOCIAL,

SUCCESS,

TALLY,

TASK,

UNKNOWN,

WAL_INCREMENTAL,

WORK_UI,

WORKFLOW_CONTACT_DELETE_ACTION,

WORKFLOWS

customProperties.sourceId

string

required

The ID of the property source indicating where it was created.

customProperties.sourceLabel

string

required

A human-readable label.

customProperties.sourceMetadata

string

required

Quellen-Metadaten kodiert als base64-Zeichenfolge. Beispiel: „ZXhhbXBsZSBzdHJpbmc=“

customProperties.sourceUpstreamDeployable

string

required

Gibt an, welcher Upstream-Dienst die Eigenschaftsänderung vorgenommen hat.

customProperties.sourceVid

integer<int64>[]

required

The unique identifier associated with the source.

customProperties.timestamp

integer<int64>

required

When the value was set, as a 64-bit integer.

customProperties.unit

string

required

The unit of measurement or context for the value.

customProperties.updatedByUserId

integer<int32>

required

The ID of the user who updated the property.

customProperties.useTimestampAsPersistenceTimestamp

boolean

required

Gibt an, ob der Persistenzzeitstempel mit dem Zeitstempel der Speicherversion übereinstimmt.

customProperties.value

string

required

Benutzerdefinierter Eigenschaftswert

eventName

string

required

Der Name des Marketingevents.

eventOrganizer

string

required

Der Name des Organisators des Marketingevents.

externalAccountId

string

required

Die accountId, die diesem Marketingevent in der externen Event-App zugeordnet ist.

externalEventId

string

required

Die ID des Marketingevents in der externen Event-App.

endDateTime

string<date-time>

Der Endzeitpunkt (Datum und Uhrzeit) des Marketingevents.

eventCancelled

boolean

Gibt an, ob das Marketingevent storniert wurde. Der Standardwert ist „false“ (falsch).

eventCompleted

boolean

Gibt an, ob das Marketingevent abgeschlossen wurde. Der Standardwert ist „false“ (falsch)

eventDescription

string

Die Beschreibung des Marketingevents.

eventType

string

Beschreibt, von welchem Typ dieses Event ist. Beispiel: „WEBINAR“, „CONFERENCE“, „WORKSHOP“

eventUrl

string

Eine URL in der externen Event-App, in der das Marketingevent verwaltet werden kann.

startDateTime

string<date-time>

Der Startzeitpunkt (Datum und Uhrzeit) des Marketingevents.

Response

successful operation

customProperties

object[]

required

Anzeigen untergeordnete attribute

customProperties.dataSensitivity

enum<string>

required

The sensitivity level of the property, such as "non_sensitive", "sensitive", and "highly_sensitive".

Verfügbare Optionen:

high,

none,

standard

customProperties.isEncrypted

boolean

required

Whether the property value is encrypted.

customProperties.isLargeValue

boolean

required

Gibt an, ob der Eigenschaftswert als großer Wert im Speicher gespeichert wird.

customProperties.name

string

required

Name der benutzerdefinierten Eigenschaft

customProperties.persistenceTimestamp

integer<int64>

required

Der Zeitstempel, der angibt, wann der geschriebene Wert im Speicher persistent gespeichert wird.

customProperties.requestId

string

required

A unique ID associated with this request.

customProperties.selectedByUser

boolean

required

Whether the value was selected by a user.

customProperties.selectedByUserTimestamp

integer<int64>

required

The timestamp when the value was selected by a user, if applicable.

customProperties.source

enum<string>

required

The origin of the property value, such as "IMPORT" or "API".

Verfügbare Optionen:

ACADEMY,

ACCEPTANCE_TEST,

ACTIVITY_AUTO_ASSOCIATE,

ADS,

AI_GROUP,

ANALYTICS,

API,

APPROVALS,

ASSISTS,

ASSOCIATIONS,

AUTO_ASSOCIATE_BY_DOMAIN,

AUTOMATION_JOURNEY,

AUTOMATION_PLATFORM,

AVATARS_SERVICE,

BATCH_UPDATE,

BCC_TO_CRM,

BEHAVIORAL_EVENTS,

BET_ASSIGNMENT,

BET_CRM_CONNECTOR,

BIDEN,

BILLING,

BOT,

CALCULATED,

CENTRAL_EXCHANGE_RATES,

CHATSPOT,

CLONE_OBJECTS,

COMMUNICATOR,

COMPANIES,

COMPANY_FAMILIES,

COMPANY_INSIGHTS,

CONTACTS,

CONTACTS_WEB,

CONTENT_MEMBERSHIP,

CONVERSATIONAL_ENRICHMENT,

CONVERSATIONS,

CRM_PROCESSES_PLATFORM,

CRM_UI,

CRM_UI_BULK_ACTION,

CUSTOMER_AGENT,

DATA_ENRICHMENT,

DATASET,

DEALS,

DEFAULT,

DELETE_OBJECTS,

EMAIL,

EMAIL_INBOX_IMPORT,

EMAIL_INTEGRATION,

ENGAGEMENTS,

EXTENSION,

FILE_MANAGER,

FLYWHEEL_PRODUCT_DATA_SYNC,

FORECASTING,

FORM,

FORWARD_TO_CRM,

GMAIL_INTEGRATION,

GOALS,

HEISENBERG,

HELP_DESK,

HELP_DESK_AI,

IMPORT,

INTEGRATION,

INTEGRATIONS_PLATFORM,

INTEGRATIONS_SYNC,

INTENT,

INTERNAL_PROCESSING,

LEADIN,

LEGAL_BASIS_REMEDIATION,

MARKET_SOURCING,

MARKETPLACE,

MEETINGS,

MERGE_COMPANIES,

MERGE_CONTACTS,

MERGE_OBJECTS,

MERGE_REVERT_OBJECTS,

MICROAPPS,

MIGRATION,

MOBILE_ANDROID,

MOBILE_IOS,

PAYMENTS,

PIPELINE_SETTINGS,

PLAYBOOKS,

PORTAL_OBJECT_SYNC,

PORTAL_USER_ASSOCIATOR,

PRESENTATIONS,

PRIMARY_AUTOMATION,

PROPERTY_DEFAULT_VALUE,

PROPERTY_RESTORE,

PROPERTY_SETTINGS,

PROSPECTING_AGENT,

QUOTAS,

QUOTES,

RECYCLING_BIN,

RESTORE_OBJECTS,

SALES,

SALES_MESSAGES,

SALESFORCE,

SEQUENCES,

SETTINGS,

SIDEKICK,

SIGNALS,

SLACK_INTEGRATION,

SOCIAL,

SUCCESS,

TALLY,

TASK,

UNKNOWN,

WAL_INCREMENTAL,

WORK_UI,

WORKFLOW_CONTACT_DELETE_ACTION,

WORKFLOWS

customProperties.sourceId

string

required

The ID of the property source indicating where it was created.

customProperties.sourceLabel

string

required

A human-readable label.

customProperties.sourceMetadata

string

required

Quellen-Metadaten kodiert als base64-Zeichenfolge. Beispiel: „ZXhhbXBsZSBzdHJpbmc=“

customProperties.sourceUpstreamDeployable

string

required

Gibt an, welcher Upstream-Dienst die Eigenschaftsänderung vorgenommen hat.

customProperties.sourceVid

integer<int64>[]

required

The unique identifier associated with the source.

customProperties.timestamp

integer<int64>

required

When the value was set, as a 64-bit integer.

customProperties.unit

string

required

The unit of measurement or context for the value.

customProperties.updatedByUserId

integer<int32>

required

The ID of the user who updated the property.

customProperties.useTimestampAsPersistenceTimestamp

boolean

required

Gibt an, ob der Persistenzzeitstempel mit dem Zeitstempel der Speicherversion übereinstimmt.

customProperties.value

string

required

Benutzerdefinierter Eigenschaftswert

eventName

string

required

Der Name des Marketingevents.

eventOrganizer

string

required

Der Name des Organisators des Marketingevents.

endDateTime

string<date-time>

Der Endzeitpunkt (Datum und Uhrzeit) des Marketingevents.

eventCancelled

boolean

Gibt an, ob das Marketingevent storniert wurde.

eventCompleted

boolean

Gibt an, ob das Marketing-Event abgeschlossen wurde.

eventDescription

string

Die Beschreibung des Marketingevents.

eventType

string

Der Typ von Marketingevent.

eventUrl

string

Die URL in der externen Event-App, in der das Marketingevent verwaltet werden kann.

objectId

string

Die ID des CRM-Objekts für das Marketingevent

startDateTime

string<date-time>

Der Startzeitpunkt (Datum und Uhrzeit) des Marketingevents.

Transaktions-E-Mail

Abo-Einstellungen v3

Abo-Einstellungen v4

Marketing-E-Mails

Marketingevents

Single-Send

Kampagnen

Formulare

Meetings

Ein Marketingevent erstellen

Authorizations

Body

Response