Guides
Delivery statuses
Read the status and error code returned by the email endpoint.
Statuses
| Status | Meaning |
|---|---|
queued |
Accepted and waiting to send. |
processing |
Sending is in progress. |
simulated |
Sandbox send completed; no email was delivered. |
submitted |
Accepted by the sending provider. |
delayed |
Delivery is temporarily delayed. |
delivered |
Accepted by the recipient’s mail server. This does not confirm it was read. |
failed |
Sending or delivery failed. Check error_code. |
bounced |
The recipient’s server rejected the email. |
complained |
The recipient reported the email as spam. |
canceled |
Sending was canceled because the template was deleted. |
Failure reasons
error_code |
What to do |
|---|---|
delivery_unknown |
Submission could not be confirmed. Check email activity before resending to avoid a duplicate. |
delivery_expired |
The email could not be sent before its delivery deadline. Check whether it is still relevant before sending a new one. |
account_inactive |
Check the workspace’s sending plan and status. |
template_deleted |
Choose a published template for a new send. |
provider_error |
Check email activity and sending setup. |
Bounce and complaint reasons may contain values reported by the sending provider.
Later updates
A submitted or delayed email may receive a later delivery result. A delivered email may later become bounced or complained. Use a polling timeout rather than waiting indefinitely for a final status.