Transactional Email Events

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

Notification Event CategoryNotification Event TypeDescription
TransactionalSendEventsEmailSentIndicates that the email was sent to the email provider.
TransactionalSendEventsEmailNotSentIndicates that the email was not sent and includes the reason.
TransactionalSendEventsEmailBouncedIndicates 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.jobIdstringMarketing Cloud Job ID
composite.batchIdstringMarketing Cloud Batch ID
composite.listIdstringMarketing Cloud 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
tostringTenant Business Id event was produced from
subscriberKeystringTenant Enterprise Id event was produced from
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
tostringTenant Business Id event was produced from
subscriberKeystringTenant Enterprise Id event was produced from
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
tostringTenant Business Id event was produced from
subscriberKeystringTenant Enterprise Id event was produced from
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