Delete subscription

This cannot be undone. All data associated with the subscription will also be deleted. We recommend unsubscribing when possible instead of deleting.

If a premium subscription is deleted they will no longer be billed.

Deletes a subscription.

Path parameters

subscriptionIdstringRequiredformat: "^(sub_[0-9a-fA-F\-]+)$"

The prefixed ID of the subscription object

publicationIdstringRequiredformat: "^(pub_[0-9a-fA-F\-]+)$"

The prefixed ID of the publication object

Response

No Content

messagestring or null

1	import requests
2
3	url = "https://api.beehiiv.com/v2/publications/pub_00000000-0000-0000-0000-000000000000/subscriptions/sub_00000000-0000-0000-0000-000000000000"
4
5	headers = {"Authorization": "Bearer <token>"}
6
7	response = requests.delete(url, headers=headers)
8
9	print(response.json())

Path parameters

Headers

Response

Errors