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_.
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.
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 which were previously premium subscribers, but have since churned but are not unsubscribed. These subscribers receive public emails as well as teasers.
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 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 that have been gifted free premium subscriptions.
Subscribers who technically have active paid subscriptions, but have not paid their invoices in time.
Subscribers that are on a temporary hold from their premium subscription, but are still subscribed to your newsletter.
Subscribers with active premium subscriptions.
Normal subscribers who have not unsubscribed or deactivated in any way.
Subscribers who have been explicitly removed by the newsletter (notably, this does not mean unsubscribers: use /v1/unsubscribers for that!)
Subscribers that are temporarily receiving a premium subscription to your newsletter.
Subscribers who have not yet confirmed their email or opted in.
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 who have not yet purchased a subscription to your newsletter. Subscribers will only be marked as unpaid if you have turned off free subscriptions to your paid newsletter; otherwise, they will be marked as Regular.
Subscribers who have a premium subscription starting in the future.
Subscribers that have or have been unsubscribed from your newsletter.