Zum Hauptinhalt springen
POST
/
marketing
/
v3
/
marketing-events
/
attendance
/
{externalEventId}
/
{subscriberState}
/
email-create
Teilnehmer nach E-Mail anhand der externen IDs des Marketingevents aufzeichnen
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/attendance/{externalEventId}/{subscriberState}/email-create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "contactProperties": {},
      "email": "<string>",
      "interactionDateTime": 123,
      "properties": {}
    }
  ]
}
'
{
  "completedAt": "2023-11-07T05:31:56Z",
  "results": [
    {
      "email": "<string>",
      "vid": 123
    }
  ],
  "startedAt": "2023-11-07T05:31:56Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "<string>",
      "context": {},
      "errors": [
        {
          "message": "<string>",
          "code": "<string>",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "<string>",
          "subCategory": "<string>"
        }
      ],
      "links": {},
      "message": "<string>",
      "status": "<string>",
      "id": "<string>",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 123,
  "requestedAt": "2023-11-07T05:31:56Z"
}

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

Authorization
string
header
erforderlich

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

Pfadparameter

externalEventId
string
erforderlich

Die ID des Marketingevents in der externen Event-Anwendung

subscriberState
string
erforderlich

Der neue Abonnentenstatus für die HubSpot-Kontakte und das angegebene Marketingevent. Zum Beispiel: „register“, „attend“ oder „cancel“.

Abfrageparameter

externalAccountId
string

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

Body

application/json
inputs
object[]
erforderlich

Liste der zu erstellenden oder zu aktualisierenden Marketingevent-Details

Antwort

successful operation

completedAt
string<date-time>
erforderlich

Zeitstempel, der angibt, wann die Verarbeitung der Anfrage abgeschlossen wurde

results
object[]
erforderlich
startedAt
string<date-time>
erforderlich

Zeitstempel, der angibt, wann das Verarbeiten der Anfrage begonnen hat

status
enum<string>
erforderlich

Status der Verarbeitung der Anfrage

Verfügbare Optionen:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

Ergebnis der Anfrage

numErrors
integer<int32>

Die Anzahl der Fehler, die während der Verarbeitung aufgetreten sind

requestedAt
string<date-time>

Zeitstempel, der angibt, wann die Anfrage gestellt wurde

Last modified on January 26, 2026