Transactional Email Events

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

Notification Event Type	Description
`TransactionalSendEvents.EmailSent`	Indicates that the email was sent to the email provider.
`TransactionalSendEvents.EmailNotSent`	Indicates that the email wasn’t sent and includes the reason.
`TransactionalSendEvents.EmailBounced`	Indicates that the email bounced and includes the reason.

Common Event Attributes

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

Attribute	Type	Description
`eventCategoryType`	string	The taxonomy of the event
`timestampUTC`	number	UTC Epoch time
`compositeId`	string	Internal tracking ID (deprecated)
`composite`	object	Object containing broken down composite ID
`composite.jobId`	string	The unique job ID.
`composite.batchId`	string	The unique batch ID.
`composite.listId`	string	The unique list ID.
`definitionKey`	string	Send Definition Customer Key (Transactional Sent Events Only)
`definitionId`	string	Send Definition Id (Transactional Sent Events Only)
`mid`	number	Tenant Business Unit Id event was produced from
`eid`	number	Tenant Enterprise Id event was produced from
`info`	object	Object containing event-specific details

Transactional Email Sent Event

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

Attribute	Type	Description
to	string	The recipient’s email address
subscriberKey	string	The unique ID of the recipient
messageKey	string	Object containing event-specific details
status	string	Result of the Sent Event
renderedSubject	string	The subject line after personalization

Transactional Email Sent Payload Example

1{
2  "eventCategoryType": "TransactionalSendEvents.EmailSent",
3  "timestampUTC": 1600698608530,
4  "compositeId": "466651f2-9c28-e911-a261-78e3b50b4f00.2001070.44609.4153.1251508322",
5  "composite": {
6    "jobId": "2001070",
7    "batchId": "4153",
8    "listId": "44609",
9    "subscriberId": "1251508322",
10    "emailId": "182583"
11  },
12  "definitionKey": "makana-appt",
13  "mid": 1447640,
14  "eid": 1447640,
15  "sendClassificationType": "Operational",
16  "info": {
17    "to": "mduarte.10166.0749@salesforce.exacttargettest.com",
18    "subscriberKey": "mduarte.10166.0749@sf.exacttargettest.com",
19    "messageKey": "f2b21aa0-fc16-11ea-9bc1-fbf804a5a66e",
20    "status": "Sent",
21    "renderedSubject": "Don't Forget Your Appointment"
22  },
23  "definitionId": "466651f2-9c28-e911-a261-78e3b50b4f00"
24}

Transactional Email Not Sent Event

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

Email Not Sent Info Attributes

Attribute	Type	Description
to	string	The recipient’s email address
subscriberKey	string	The unique ID of the recipient
messageKey	string	Object containing event-specific details
reason	string	The descriptive reason
statusCode	string	The subscriber error code
statusMessage	string	The subscriber error message

TransactionalSendEvents.EmailNotSent Payload Example

1[
2  {
3    "eventCategoryType": "TransactionalSendEvents.EmailNotSent",
4    "timestampUTC": 1600630238373,
5    "compositeId": "3d9ee7e3-57f1-e911-a2d6-1402ec8faa09.1722202.69399.0.0",
6    "definitionKey": "makana-appt",
7    "mid": 1476456,
8    "eid": 1476266,
9    "info": {
10      "to": "mduarte.10166.0749@sf.exacttargettest.com",
11      "subscriberKey": "101660749",
12      "messageKey": "c3896725-6847-40bd-9217-dda17ee6cba2",
13      "reason": "The subscriber ExactTarget system status is unsubscribed",
14      "statusCode": "1",
15      "statusMessage": "Unsubscribed"
16    },
17    "definitionId": "3d9ee7e3-57f1-e911-a2d6-1402ec8faa09",
18    "composite": {
19      "jobId": "2001070",
20      "batchId": "4153",
21      "listId": "44609",
22      "subscriberId": "1251508322",
23      "emailId": "182583"
24    }
25  }
26]

Transactional Email Bounced Event

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

Attribute	Type	Description
`to`	string	The recipient’s email address
`subscriberKey`	string	The unique ID of the recipient
`messageKey`	string	Object containing event-specific details
`bounceCode`	string	The type of bounce - “HARD” or “SOFT”
`bounceMessage`	string	The string from the recipient email send the provider
`smtpReason`	string	The error value of the SMTP reason

1[
2  {
3    "eventCategoryType": "TransactionalSendEvents.EmailBounced",
4    "timestampUTC": 1583849944000,
5    "compositeId": "9bcfe8e8-5a3b-e911-a2c7-1402ec83d7c0.1888699.69238.29.207500672",
6    "definitionKey": "makana-appt",
7    "mid": 1476456,
8    "eid": 1476266,
9    "info": {
10      "to": "mduarte.10166.0749@sf.exacttargettest.com",
11      "subscriberKey": "5bed12d54c74fd93ee1de599",
12      "messageKey": "hJlMt8-fckKT4silLiVusA",
13      "bounceCode": "HARD",
14      "bounceMessage": "5.1.1 (bad destination mailbox address) User Unknown",
15      "smtpReason": "5.1.1"
16    },
17    "definitionId": "9bcfe8e8-5a3b-e911-a2c7-1402ec83d7c0",
18    "composite": {
19      "jobId": "2001070",
20      "batchId": "4153",
21      "listId": "44609",
22      "subscriberId": "1251508322",
23      "emailId": "297967"
24    }
25  }
26]