Account & Settings
Gestion des applications
Authentification
Automatisation
CMS
Communication preferences
Conversations
Événements
Fichiers
Scheduler
curl --request POST \
--url https://api.hubapi.com/marketing/transactional/2026-03/single-email/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactProperties": {},
"customProperties": {},
"emailId": 123,
"message": {
"bcc": [
"<string>"
],
"cc": [
"<string>"
],
"replyTo": [
"<string>"
],
"from": "<string>",
"sendId": "<string>",
"to": "<string>"
}
}
'{
"status": "CANCELED",
"statusId": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"eventId": {
"created": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"message": "<string>",
"requestedAt": "2023-11-07T05:31:56Z",
"sendResult": "ADDRESS_LIST_BOMBED",
"startedAt": "2023-11-07T05:31:56Z"
}Send a transactional email
Envoyez un e-mail transactionnel de manière asynchrone. Retourne le statut de l’envoi de l’e-mail avec un ID de statut qui peut être utilisé pour interroger continuellement le statut en utilisant l’API de statut d’envoi d’e-mail.
curl --request POST \
--url https://api.hubapi.com/marketing/transactional/2026-03/single-email/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"contactProperties": {},
"customProperties": {},
"emailId": 123,
"message": {
"bcc": [
"<string>"
],
"cc": [
"<string>"
],
"replyTo": [
"<string>"
],
"from": "<string>",
"sendId": "<string>",
"to": "<string>"
}
}
'{
"status": "CANCELED",
"statusId": "<string>",
"completedAt": "2023-11-07T05:31:56Z",
"eventId": {
"created": "2023-11-07T05:31:56Z",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
},
"message": "<string>",
"requestedAt": "2023-11-07T05:31:56Z",
"sendResult": "ADDRESS_LIST_BOMBED",
"startedAt": "2023-11-07T05:31:56Z"
}Supported products
Supported products
Required Scopes
Required Scopes
Autorisations
The access token received from the authorization server in the OAuth 2.0 flow.
Corps
Le champ contact « Propriété » est une carte des valeurs de propriété de contact. Chaque valeur de propriété de contact contient une propriété de nom et de valeur. Chaque propriété sera définie sur l'enregistrement de contact et sera visible dans le modèle sous {{ contact.NAME }}. Utilisez ces propriétés lorsque vous souhaitez définir une propriété de contact pendant l'envoi de l'e-mail. Par exemple, lors de l'envoi d'un reçu, vous voudrez peut-être définir une propriété last_paid_date, car l'envoi du reçu aura des informations sur le dernier paiement.
Show child attributes
Show child attributes
Le champ personnalisé « Properties » est une carte de valeurs de propriété. Chaque valeur de propriété contient un nom et une propriété de valeur. Chaque propriété sera visible dans le modèle sous {{ custom.NAME }}. Note : les propriétés personnalisées ne prennent actuellement pas en charge les tableaux. Pour fournir une liste dans un e-mail, une solution de contournement consiste à créer une liste HTML (soit avec des tables, soit avec ul) et à la spécifier comme propriété personnalisée.
Show child attributes
Show child attributes
L'ID de contenu pour l'e-mail transactionnel, trouvable dans l'interface utilisateur de l'outil d'e-mail.
Show child attributes
Show child attributes
Réponse
successful operation
Statut de la demande d'envoi.
CANCELED, COMPLETE, PENDING, PROCESSING Identifiant utilisé pour interroger le statut de l'envoi.
Heure à laquelle l'envoi a été effectué.
Show child attributes
Show child attributes
Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant
Heure à laquelle l'envoi a été demandé.
Résultat de l'envoi.
ADDRESS_LIST_BOMBED, ADDRESS_ONLY_ACCEPTED_ON_PROD, ADDRESS_OPTED_OUT, ATTACHMENT_DOWNLOAD_QUEUE_FULL, BLOCKED_ADDRESS, BLOCKED_DOMAIN, BRAND_RECIPIENT_FATIGUE_SUPPRESSED, CAMPAIGN_CANCELLED, CANCELLED_ABUSE, CORRUPT_INPUT, EMAIL_DISABLED, EMAIL_UNCONFIRMED, GDPR_DOI_ENABLED, GRAYMAIL_SUPPRESSED, HUBL_LIMIT_EXCEEDED, IDEMPOTENT_FAIL, IDEMPOTENT_IGNORE, INVALID_APP_ID_ATTRIBUTION, INVALID_FROM_ADDRESS, INVALID_TO_ADDRESS, LOW_CONTACT_QUALITY_SCORE, MISSING_CONTENT, MISSING_REQUIRED_PARAMETER, MISSING_TEMPLATE_PROPERTIES, MTA_IGNORE, NON_MARKETABLE_CONTACT, PORTAL_AUTHENTICATION_FAILURE, PORTAL_EXPIRED, PORTAL_MISSING_MARKETING_SCOPE, PORTAL_NOT_AUTHORIZED_FOR_APPLICATION, PORTAL_OVER_LIMIT, PORTAL_SUSPENDED, PREVIOUS_SPAM, PREVIOUSLY_BOUNCED, PREVIOUSLY_UNSUBSCRIBED_BRAND, PREVIOUSLY_UNSUBSCRIBED_BUSINESS_UNIT, PREVIOUSLY_UNSUBSCRIBED_MESSAGE, PREVIOUSLY_UNSUBSCRIBED_PORTAL, QUARANTINED_ADDRESS, QUEUED, RECIPIENT_FATIGUE_SUPPRESSED, SENT, TEMPLATE_RENDER_EXCEPTION, THROTTLED, TOO_MANY_RECIPIENTS, UBB_GOVERNANCE_MISSING, UNCONFIGURED_SENDING_DOMAIN, UNDELIVERABLE, VALIDATION_FAILED Heure à laquelle l'envoi a commencé à être traité.