Passer au contenu principal
POST
/
marketing
/
v3
/
marketing-events
/
attendance
/
{externalEventId}
/
{subscriberState}
/
email-create
Enregistrer des participants par e-mail avec les ID externes de l'événement marketing
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"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

externalEventId
string
requis

L'identifiant de l'événement marketing dans l'application d'événements externe

subscriberState
string
requis

Le nouveau statut d'abonné pour les contacts HubSpot et l'événement marketing spécifié. Par exemple : « s'inscrire », « participer » ou « annuler ».

Paramètres de requête

externalAccountId
string

L'ID de compte associé à cet événement marketing dans l'application d'événement externe.

Corps

application/json
inputs
object[]
requis

Liste des détails de l'événement marketing à créer ou mettre à jour

Réponse

successful operation

completedAt
string<date-time>
requis

Horodatage indiquant quand le traitement de la requête s'est terminé.

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

Horodatage indiquant quand le traitement de la requête a commencé.

status
enum<string>
requis

Statut du traitement de la demande

Options disponibles:
CANCELED,
COMPLETE,
PENDING,
PROCESSING
errors
object[]

Résultat de la demande

numErrors
integer<int32>

Le nombre d'erreurs survenues pendant le traitement

requestedAt
string<date-time>

Horodatage indiquant le moment où la demande a été effectuée

Last modified on December 9, 2025