Buttondown logo

Get started

Routes

IntroductionTypesSourcesUndeliverability reasons

Routes

Listing subscribersRetrieving a subscriberCreating a subscriberUpdating a subscriberDeleting a subscriberSending a reminderSending an emailListing survey responsesSubscriber referralsSending a magic linkSubscriber automationsUpdating a subscriber's automationSubscriber Stripe subscriptions

Buttondown logo

Deleting a subscriber

Note that deleting a subscriber with an active Stripe subscription will not cancel any backing Stripe subscriptions tied to that subscriber. If you're interested in programmatically cancelling a subscriber's Stripe subscription, be sure to update the subscriber's type to unsubscribed beforehand.

Sample requests

These sample requests are autogenerated by the OpenAPI spec. This endpoint requires one or more parameters in the URL: those are offset in curly-braces.

import requests

url = "https://api.buttondown.com/v1/subscribers/{id_or_email}"
headers = {
  "Authorization": "Token $BUTTONDOWN_API_KEY"
}

response = requests.request("DELETE", url, headers=headers)
print(response.text)

Sample responses

The IDs and values referenced in these responses are fake; please only rely on these responses for overall structure.

{}