Buttondown Documentation
As you'll see, most of the logic here is really to deal with the state space of paid subscriptions, and therefore might not be super relevant to you.
Which is why we also present this chart without paid subscriptions_.
Represents the state of a subscriber and what emails they should or should not be receiving. This type is meant to be fully expressive so as to consolidate the logic of determining what emails a subscriber should receive into a single place.
Note that the only types that can be set programmatically are REGULAR, UNSUBSCRIBED, GIFTED and UNPAID. All other types are meant to be user-visible and cannot be set programmatically.
Normal subscribers who have not unsubscribed or deactivated in any way.
Subscribers with active premium subscriptions.
Subscribers that were automatically blocked from signing up for your newsletter by Buttondown's automated filtering systems. You can review the subscriber's email address and make a decision about whether to allow them to subscribe.
Subscribers that are temporarily receiving a premium subscription to your newsletter.
Subscribers who have not yet purchased a subscription to your newsletter.
Subscribers that have been gifted free premium subscriptions.
Subscribers who have elected to not renew their subscription to your newsletter and will become unpaid subscribers at the end of their current billing period.
Subscribers who have not yet confirmed their email or opted in.
Subscribers that are on a temporary hold from their premium subscription, but are still subscribed to your newsletter.
Subscribers that have or have been unsubscribed from your newsletter.
Subscribers that have been deemed spammy by Buttondown's automated systems.
Buttondown marks subscribers as undeliverable when we receive some sort of proof that this address does not exist, such as a suppression notification from one of our email providers or a hard bounce from the host or mailbox itself. We don't try to deliver email to subscribers marked as undeliverable, but you can, in some cases, change their email address (e.g. if they've changed their email address in your CRM, or if you had a typo in their email address) to try and fix things.
Subscribers that have registered a complaint with their email provider. Buttondown will not try to send them any future emails; no action is required on your part.
Subscribers whose email appears to be invalid.
Subscribers who have been explicitly removed by the newsletter (notably, this does not mean unsubscribers: use /v1/unsubscribers for that!)
Subscribers who have been disabled by the newsletter.
Subscribers who have been deemed disposable by Buttondown's automated systems.
Subscribers who technically have active paid subscriptions, but have not paid their invoices in time.
Subscribers which were previously premium subscribers, but have since churned but are not unsubscribed.