Represents the state of an email.
No action is required to move from one state or another; Buttondown
internally handles the transitions, and exposing the status is for
observability purposes only.
Draft
Type
draft
Description
Draft emails are only visible to you and are not sent out to subscribers.
About to send
Type
about_to_send
Description
This email has been queued to send out to subscribers, and will be sent automatically within a few minutes.
If you're seeing that an email you just sent out is 'stuck' here, worry not — Buttondown sometimes takes a little bit longer to send out emails to ensure deliverability, but once it's marked as 'about to send' it will get sent out.
Scheduled
Type
scheduled
Description
This email has been scheduled to send out to subscribers at a specific time. This specific time is available on the email as its `publish_date`.
In flight
Type
in_flight
Description
This email is currently being sent out to subscribers, and is visible in your web archives if enabled.
Some emails, especially those with large subscriber lists, may take a while to send out — Buttondown sends emails out in batches to ensure deliverability, so if you're seeing an email 'stuck' here, it's because our systems have detected that that's the optimal way to reach your subscribers.
Imported
Type
imported
Description
This email was imported from another service, and is visible in your web archives if enabled.
Type
managed_by_rss
Description
This email was created by an external feed, and has not yet been finalized and sent out by Buttondown.
Deleted
Type
deleted
Description
This email has been deleted, and is no longer visible in your web archives.
Paused
Type
paused
Description
This email has been paused, and is not visible in your web archives.
Sent
Type
sent
Description
This email has been sent out to subscribers, and is visible in your web archives if enabled.
Errored
Type
errored
Description
This email has encountered an error while sending out to subscribers, and is not visible in your web archives.
Referenced by
Customizing email list viewScheduling emails via the API