HUhubspot
Send transactional email

Send a single send transactional email asynchronously.

Changed on

Asynchronously send a transactional email. Returns the status of the email send with a statusId that can be used to continuously query for the status using the Email Send Status API.

post/marketing/transactional/2026-09/single-email/send

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/marketing/transactional/2026-09/single-email/send
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: transactional-email

Request body

contactPropertiesobject required

The contactProperties field is a map of contact property values. Each contact property value contains a name and value property. Each property will get set on the contact record and will be visible in the template under {{ contact.NAME }}. Use these properties when you want to set a contact property while you’re sending the email. For example, when sending a reciept you may want to set a last_paid_date property, as the sending of the receipt will have information about the last payment.

customPropertiesobject required

The customProperties field is a map of property values. Each property value contains a name and value property. Each property will be visible in the template under {{ custom.NAME }}. Note: Custom properties do not currently support arrays. To provide a listing in an email, one workaround is to build an HTML list (either with tables or ul) and specify it as a custom property.

emailIdinteger required

The content ID for the transactional email, which can be found in email tool UI.

Response

successful operation

completedAtstring date-time

Time when the send was completed.

messagestring

A human readable message describing the error along with remediation steps where appropriate

requestedAtstring date-time

Time when the send was requested.

sendResult'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'

Result of the send.

startedAtstring date-time

Time when the send began processing.

status'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING' required

Status of the send request.

statusIdstring required

Identifier used to query the status of the send.

Changes

  • 2026-09a04185df14f9Revision changes
    • warning

      added the new CONTACT_VIEW_PERMISSION enum value to the response property for the response status

    • warning

      added the new MARKETING_ACTIVATION_DISALLOWED enum value to the response property for the response status

    • info

      the endpoint scheme security private_apps was removed from the API