Concepts
Email lifecycle
The statuses an email goes through, from the POST to delivery, and the events you get for each one.
From send to delivery
POST /emails only queues the email and responds 202 with the id. The worker takes it from the queue, hands it to the SMTP relay and records each step as an event. Read the events at GET /emails/{id}/events or receive them through webhooks.
- queued: accepted and in the queue.
- scheduled: scheduled for scheduledAt.
- processing: the worker is sending it.
- sent: the relay accepted the message.
- delivered: the recipient server confirmed receipt.
GET /emails/{id}/events
Negative outcomes
Not every email arrives. When it does not, the final status says why, and the address may be added to the suppression list automatically.
- bounced: the server refused it (a hard bounce suppresses the address).
- complained: the recipient marked it as spam (the address is suppressed).
- failed: sending failed after retries.
- skipped: the address was suppressed and the email was not sent.
- cancelled: the schedule was cancelled before sending.
Engagement
With tracking enabled on the domain, opens and clicks become opened and clicked events. They do not change the delivery status.