Transactional Email Events

The Event Notification Service supports these event notification types and their corresponding payloads.

Notification Event TypeDescription
TransactionalSendEvents.EmailSentIndicates that the email was sent to the email provider.
TransactionalSendEvents.EmailNotSentIndicates that the email was not sent and includes the reason.
TransactionalSendEvents.EmailBouncedIndicates that the email bounced and includes the reason.

All or some of these attributes are shared for all event data payloads.

AttributeTypeDescription
eventCategoryTypestringThe taxonomy of the event
timestampUTCnumberUTC Epoch time
compositeIdstringInternal tracking ID (deprecated)
compositeobjectObject containing broken down composite ID
composite.jobIdstringThe unique job ID.
composite.batchIdstringThe unique batch ID.
composite.listIdstringThe unique list ID.
definitionKeystringSend Definition Customer Key (Transactional Sent Events Only)
definitionIdstringSend Definition Id (Transactional Sent Events Only)
midnumberTenant Business Unit Id event was produced from
eidnumberTenant Enterprise Id event was produced from
infoobjectObject containing event-specific details

This event notification payload is an example of what your callback receives for a TransactionalSendEvents.EmailSent event.

AttributeTypeDescription
tostringThe recipient's email address
subscriberKeystringThe unique ID of the recipient
messageKeystringObject containing event-specific details
statusstringResult of the Sent Event
renderedSubjectstringThe subject line after personalization

This event notification payload is an example of what your callback receives for a TransactionalSendEvents.EmailNotSent event.

AttributeTypeDescription
tostringThe recipient's email address
subscriberKeystringThe unique ID of the recipient
messageKeystringObject containing event-specific details
reasonstringThe descriptive reason
statusCodestringThe subscriber error code
statusMessagestringThe subscriber error message

This event notification payload is an example of what your callback receives for a TransactionalSendEvents.EmailBounced event.

AttributeTypeDescription
tostringThe recipient's email address
subscriberKeystringThe unique ID of the recipient
messageKeystringObject containing event-specific details
bounceCodestringThe type of bounce - "HARD" or "SOFT"
bounceMessagestringThe string from the recipient email send the provider
smtpReasonstringThe error value of the SMTP reason