Account & Settings
Gestión de aplicaciones
Autenticación
Automatización
CMS
Communication preferences
Conversaciones
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
Envía un correo transaccional de forma asíncrona. Devuelve el estado del envío con un statusId que se puede usar para consultar el estado utilizando la API de estado de envío de correo.
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
Autorizaciones
The access token received from the authorization server in the OAuth 2.0 flow.
Cuerpo
El campo contactProperties es un mapa de valores de propiedad de contacto. Cada uno de estos valores contiene una propiedad de nombre y valor. Cada propiedad se establecerá en el registro de contacto y será visible en la plantilla bajo {{ contact.NAME }}. Utiliza estas propiedades cuando desees establecer una propiedad de contacto mientras envías el correo. Por ejemplo, al enviar un recibo, puede que desees establecer una propiedad last_paid_date, ya que el envío del recibo tendrá información sobre el último registro de pago.
Show child attributes
Show child attributes
El campo customProperties es un mapa de valores de propiedad. Cada uno de estos valores contiene una propiedad de nombre y valor. Cada propiedad será visible en la plantilla bajo {{ custom.NAME }}. Nota: Las propiedades personalizadas actualmente no admiten secuencias. Para proporcionar una lista en un correo, un método alternativo es construir una lista HTML (ya sea con tablas o ul) y especificarla como una propiedad personalizada.
Show child attributes
Show child attributes
El ID del contenido del correo transaccional, que se puede encontrar en la UI de la herramienta de correo.
Show child attributes
Show child attributes
Respuesta
successful operation
Estado de la solicitud de envío.
CANCELED, COMPLETE, PENDING, PROCESSING Identificador utilizado para consultar el estado del envío.
La hora cuando se completó el envío.
Show child attributes
Show child attributes
Un mensaje legible en el que se describa el error y los pasos para solucionarlo, si procede
La hora cuando se solicitó el envío.
Resultado del envío.
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 La hora cuando comenzó el procesamiento del envío.