Resources

Email lifecycle

Every email status and how emails move between them.

Statuses

Every email you send carries a status. It starts at queued and moves forward as it is handed to the mail provider and SES reports delivery events back.

Status	Meaning
`queued`	Accepted, being processed
`sent`	Handed to provider
`delivered`	SES `Delivery`
`bounced`	SES `Bounce`
`complained`	SES `Complaint`
`opened`	Tracking pixel after delivery
`clicked`	Tracking link after delivery

How emails move between statuses

Send — POST /v1/emails accepts the email as queued; when it is handed to the mail provider, the status flips to sent.
Delivery — an SES Delivery event moves the email to delivered.
Bounce — an SES Bounce event moves the email to bounced and flips the linked contact to bounced as well.
Complaint — an SES Complaint event (recipient marks the email as spam) moves the email to complained and flips the linked contact to complained.
Opens and clicks — when the recipient loads the tracking pixel or clicks a tracked link, the status moves to opened / clicked. See Tracking and events.

Status visibility

There is no public status-polling endpoint today: statuses are dashboard-only. To watch how events flow back from SES in real time, see Tracking and events.

Edit this page

Plans

The public plan catalog — free, paid and custom plans with tiers, limits and send rates.

Contact statuses

subscribed, unsubscribed, bounced, complained — and what suppresses resubscription.