Emails
Statuses
Every email moves through a lifecycle of statuses as it's processed and delivered.
Every email moves through a lifecycle of statuses as it's processed and delivered.
| Status | Meaning |
|---|---|
| queued | Email has been accepted and is waiting to be processed by the send worker. |
| scheduled | Email was created with scheduled_at and is waiting for its send time. It can still be rescheduled or canceled. |
| canceled | A scheduled email was canceled before its send time. Terminal — it will not send, and the send is refunded to your monthly quota. |
| sending | Email is being handed to the mail server for delivery. |
| sent | The mail server accepted the message and it is en route to the recipient. |
| delivered | Delivery confirmed. |
| bounced | Email hard-bounced — the receiving server permanently rejected it (e.g. invalid address). The address is automatically suppressed. Transient (soft) failures are retried and do not set this status. |
| complained | Recipient reported the email as spam. Address is automatically suppressed. |
| suppressed | The recipient address is on the suppression list — email was not sent. |
| failed | Unrecoverable send failure after all retry attempts. |