> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Send a transactional email > Enviar um e-mail transacional de forma assíncrona. Retorna o status do envio do e-mail com um statusId que pode ser usado para consultar continuamente o status usando a API de status de envio de e-mail. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2026-03/marketing-transactional-single-send-v2026-03.json POST /marketing/transactional/2026-03/single-email/send openapi: 3.0.1 info: title: Envio único transacional description: Basepom for all HubSpot Projects version: 2026-03 x-hubspot-product-tier-requirements: marketing: PROFESSIONAL sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE x-hubspot-api-use-case: >- Depois que um cliente converte ou compra um produto da sua empresa, você deseja enviar a ele um recibo da transação. x-hubspot-introduction: >- Use a API de e-mail transacional para enviar e-mails de um endereço IP dedicado para seus contatos para transações essenciais, incluindo atualizações de conta ou alterações nos termos de serviço. servers: - url: https://api.hubapi.com security: [] tags: - name: Send transactional email - name: SMTP Tokens paths: /marketing/transactional/2026-03/single-email/send: post: tags: - Send transactional email summary: Envie um único e-mail transacional de forma assíncrona. description: >- Enviar um e-mail transacional de forma assíncrona. Retorna o status do envio do e-mail com um statusId que pode ser usado para consultar continuamente o status usando a API de status de envio de e-mail. operationId: post-/marketing/transactional/2026-03/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: >- O campo contactProperties é um mapa de valores de propriedade do contato. Cada valor de propriedade do contato contém uma propriedade de nome e valor. Cada propriedade será definida no registro do contato e será visível no modelo em {{ contact.NAME }}. Use essas propriedades quando quiser definir uma propriedade do contato ao enviar o e-mail. Por exemplo, ao enviar um recibo, você pode querer definir uma propriedade last_paid_date, pois o envio do recibo terá informações sobre o último pagamento. customProperties: type: object additionalProperties: type: object properties: {} description: >- O campo customProperties é um mapa de valores de propriedade. Cada valor de propriedade contém uma propriedade de nome e valor. Cada propriedade será visível no modelo em {{ custom.NAME }}. Observação: propriedades personalizadas atualmente não são compatíveis com matrizes. Para fornecer uma lista em um e-mail, uma solução alternativa é construir uma lista HTML (seja com tabelas ou ul) e especificá-la como uma propriedade personalizada. emailId: type: integer description: >- O ID de conteúdo para o e-mail transacional, que pode ser encontrado na UI da ferramenta de e-mail. format: int64 message: $ref: '#/components/schemas/PublicSingleSendEmail' EmailSendStatusView: required: - status - statusId type: object properties: completedAt: type: string description: A hora em que o envio foi concluído. format: date-time eventId: $ref: '#/components/schemas/EventIdView' message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado requestedAt: type: string description: A hora em que o envio foi solicitado. format: date-time sendResult: type: string description: O resultado do envio. 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: A hora em que o envio começou a ser processado. format: date-time status: type: string description: O status da solicitação de envio. enum: - CANCELED - COMPLETE - PENDING - PROCESSING statusId: type: string description: O identificador usado para consultar o status do envio. PublicSingleSendEmail: required: - bcc - cc - replyTo type: object properties: bcc: type: array description: Lista de endereços de e-mail para enviar como Cco. items: type: string cc: type: array description: Lista de endereços de e-mail para enviar como Cc. items: type: string from: type: string description: O cabeçalho De para o e-mail. replyTo: type: array description: Lista de valores de cabeçalho Reply-To para o e-mail. items: type: string sendId: type: string description: >- ID para um envio específico. Não mais de um e-mail será enviado por sendId. to: type: string description: O destinatário do e-mail. EventIdView: required: - created - id type: object properties: created: type: string description: A hora da criação do evento. format: date-time id: type: string description: O identificador do evento. format: uuid Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. 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: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. 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: '' ````