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"
  }
}

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
requis

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

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 December 9, 2025