Passer au contenu principal
POST
/
marketing
/
v3
/
marketing-events
/
events
/
{externalEventId}
/
{subscriberState}
/
email-upsert
Enregistrer l'état d'un abonné par e-mail de contact
curl --request POST \
  --url https://api.hubapi.com/marketing/v3/marketing-events/events/{externalEventId}/{subscriberState}/email-upsert \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputs": [
    {
      "contactProperties": {},
      "email": "<string>",
      "interactionDateTime": 123,
      "properties": {}
    }
  ]
}
'
{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

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
subscriberState
string
requis

Paramètres de requête

externalAccountId
string
requis

Corps

application/json
inputs
object[]
requis

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

Réponse

default - */*
category
string
requis

La catégorie d'erreur

correlationId
string<uuid>
requis

Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreur ou tickets d'assistance

Exemple:

"aeb5f871-7f07-4993-9211-075dc63e7cbf"

message
string
requis

Un message lisible par la personne décrivant l'erreur ainsi que les étapes de remédiation appropriées, le cas échéant

Exemple:

"An error occurred"

context
object

Contexte concernant la condition d'erreur

Exemple:

"{invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]}"

errors
object[]

informations supplémentaires sur l'erreur

Une carte des noms de liens vers les URI associés contenant la documentation sur l'erreur ou les étapes de remédiation recommandées

subCategory
string

Une catégorie spécifique qui contient des détails plus précis sur l'erreur

Last modified on April 13, 2026