> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-09/marketing-transactional-single-send-v2026-09.json POST /marketing/transactional/2026-09/single-email/send openapi: 3.0.1 info: title: Envoi unique transactionnel description: Basepom for all HubSpot Projects version: 2026-09 x-hubspot-product-tier-requirements: marketing: PROFESSIONAL sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Après qu'un client a converti ou acheté un produit de votre entreprise, vous souhaitez lui envoyer un reçu de sa transaction. x-hubspot-introduction: >- Utilisez l'API d'e-mail transactionnel pour envoyer des e-mails depuis une adresse IP dédiée à vos contacts pour des transactions commerciales essentielles, comprenant les mises à jour de compte ou les changements de conditions générale d'utilisation. servers: - url: https://api.hubapi.com security: [] tags: - name: Send transactional email - name: SMTP Tokens paths: /marketing/transactional/2026-09/single-email/send: post: tags: - Send transactional email summary: Envoyer un seul e-mail transactionnel de manière asynchrone. description: >- 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. operationId: post-/marketing/transactional/2026-09/single-email/send_sendEmail parameters: [] requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicSingleSendRequestEgg' required: true responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/EmailSendStatusView' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - transactional-email components: schemas: PublicSingleSendRequestEgg: required: - contactProperties - customProperties - emailId - message type: object properties: contactProperties: type: object additionalProperties: type: string description: "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." customProperties: type: object additionalProperties: type: object properties: {} description: "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 }}.\nNote\_: 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." emailId: type: integer description: >- L'ID de contenu pour l'e-mail transactionnel, trouvable dans l'interface utilisateur de l'outil d'e-mail. format: int64 message: $ref: '#/components/schemas/PublicSingleSendEmail' EmailSendStatusView: required: - status - statusId type: object properties: completedAt: type: string description: Heure à laquelle l'envoi a été effectué. format: date-time eventId: $ref: '#/components/schemas/EventIdView' message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant requestedAt: type: string description: Heure à laquelle l'envoi a été demandé. format: date-time sendResult: type: string description: Résultat de l'envoi. enum: - 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 - CONTACT_VIEW_PERMISSION - 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 - MARKETING_ACTIVATION_DISALLOWED - 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 startedAt: type: string description: Heure à laquelle l'envoi a commencé à être traité. format: date-time status: type: string description: Statut de la demande d'envoi. enum: - CANCELED - COMPLETE - PENDING - PROCESSING statusId: type: string description: Identifiant utilisé pour interroger le statut de l'envoi. PublicSingleSendEmail: required: - bcc - cc - replyTo type: object properties: bcc: type: array description: Liste des adresses e-mail à envoyer en Cci. items: type: string cc: type: array description: Liste des adresses e-mail à envoyer en Cc. items: type: string from: type: string description: "L'en-tête «\_De\_» pour l'email." replyTo: type: array description: "Liste des valeurs d'en-tête «\_Répondre à\_» pour l'email." items: type: string sendId: type: string description: >- ID pour un envoi particulier. Pas plus d'un e-mail ne sera envoyé par ID d'envoi. to: type: string description: Le destinataire de l'e-mail. EventIdView: required: - created - id type: object properties: created: type: string description: Heure de création de l'événement. format: date-time id: type: string description: Identifiant de l'événement. format: uuid Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: 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 ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: Le nom du champ ou du paramètre dans lequel l'erreur a été trouvée. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: transactional-email: '' ````