Get Transactional Email Events

Retrieve the event timeline for a specific transactional email.

Use Cases:

• View the complete delivery lifecycle of an email
• Debug delivery issues by examining SMTP responses
• Track engagement events (opens, clicks) with geographic data
• Investigate bounce reasons and classifications
• Build detailed email activity logs

Behavior:

• Returns all events in chronological order (oldest first)
• Events include SMTP response details where applicable
• Open and click events include geographic and device information
• Bounce events include classification details
• Email must belong to your workspace

Required Scope: smtp:send

Event Types:

• SENT: Email accepted by the sending server
• DELIVERED: Email accepted by the recipient's mail server
• OPENED: Recipient opened the email (open tracking required)
• CLICKED: Recipient clicked a link (click tracking required)
• BOUNCED: Email was rejected or bounced
• COMPLAINED: Recipient marked email as spam

Response Includes:

• Event ID, type, and timestamp
• SMTP response details (code, content, command)
• Bounce classification for bounce events
• Geographic origin (country, city) for open/click events
• Device and browser information for open/click events
• Receiving mail server name