Overview
Every email in Emailit has a status that tells you exactly where it is in its lifecycle. There are 12 statuses, each with a distinct color and meaning. The status always holds the most recent status of the email.
Status Reference
| Status | Color | Description |
|---|---|---|
| accepted | 🟡 | The email has been accepted for delivery and is being processed. |
| scheduled | 🟡 | The email is scheduled for delivery at a future time specified by scheduled_at. |
| delivered | 🟢 | The email was successfully delivered to the recipient’s mail server. |
| bounced | 🔴 | The email permanently failed to deliver. The recipient’s mail server rejected the message (hard bounce). |
| attempted | 🟠 | Delivery was attempted but resulted in a temporary failure. The system may retry automatically. |
| failed | 🔴 | The email failed to deliver due to a specific error during the delivery process. |
| rejected | 🔴 | The email was initially accepted for delivery but was rejected afterwards. |
| loaded | 🔵 | The email content was loaded by the recipient. This is used for open tracking and requires tracking to be enabled on the sending domain. |
| clicked | 🟣 | A link inside the email was clicked by the recipient. Requires click tracking to be enabled on the sending domain. |
| suppressed | ⚪ | The recipient’s email address is on the suppression list and the email was not sent. |
| received | 🟢 | An incoming email was received on your domain. |
| complained | 🔴 | A spam complaint (feedback loop) was registered for this email by the recipient. |
Status Flow
A typical email goes through the following flow:
- accepted — the email enters the system
- delivered — the recipient’s mail server accepts it
- loaded — the recipient opens the email (if tracking is enabled)
- clicked — the recipient clicks a link (if tracking is enabled)
If something goes wrong, the email may end up in one of the failure states:
- attempted — temporary failure, may be retried
- bounced — permanent failure, will not be retried
- failed — delivery error
- rejected — rejected after initial acceptance
Scheduled Emails
When you send an email with a scheduled_at timestamp in the future, it enters the scheduled status instead of accepted. The email will be processed and delivered at the specified time.
You can cancel a scheduled email before it is sent, or update its scheduled time.
Suppressed Emails
If the recipient is on your workspace’s suppression list, the email will immediately receive the suppressed status and will not be delivered. This protects your sender reputation by avoiding known bad addresses.
Tracking Statuses
The loaded and clicked statuses require tracking to be enabled on your sending domain. When enabled:
- loaded is recorded when the tracking pixel in the email is fetched
- clicked is recorded when a tracked link in the email is followed
These statuses include additional metadata such as the recipient’s IP address and user agent.
Checking Email Status
You can check the current status of any email using the Get Email endpoint, or browse email statuses in the Emailit Dashboard.