> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.beehiiv.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.beehiiv.com/_mcp/server.

# Subscription Tier Deleted

POST 

Reference: https://developers.beehiiv.com/webhooks/subscription/tier-deleted

## Request

### Payload

- `data` (SubscriptionData, optional)
- `event_timestamp` (integer, optional) — The date the event was created. Measured in seconds since the Unix epoch.
- `event_type` (string, optional) — The event type.
- `uid` (string, optional) — The prefixed event ID, unique to each webhook event.

## Types

### SubscriptionData

- `created` (integer, optional) — The time the subscription was created. Measured in seconds since the Unix epoch.
- `email` (string, optional) — The email address of the subscription.
- `id` (string, optional) — The prefixed ID of the subscription.
- `referral_code` (string, optional) — The code associated to this subscriber to refer others. When a new subscription is created with this referral code, credit for the referral goes to this subscription.
- `referring_site` (string, optional) — The website that the subscriber was referred from.
- `status` (enum, optional) — The status of the subscription.
  - Allowed values: `validating`, `invalid`, `pending`, `active`, `inactive`, `needs_attention`
- `subscription_tier` (string, optional) — The tier of the subscription.
- `subscription_premium_tier_names` (list of string, optional) — The names of the premium tiers associated with the subscription.
- `stripe_customer_id` (string, optional) — The Stripe customer ID associated with the subscription.
- `utm_campaign` (string, optional) — The acquisition campaign that the subscriber was acquired from.
- `utm_channel` (string, optional) — The channel that the subscriber was acquired from.
- `utm_medium` (string, optional) — The medium that the subscriber was acquired from.
- `utm_source` (string, optional) — The source that the subscriber was acquired from.
- `custom_fields` (list of CustomFieldValue, optional) — An array of custom field values that have been set on the subscription. Each custom field value includes the field name, kind (type), and formatted value.
- `tags` (list of string, optional) — An array of tag names that have been applied to the subscription.

### CustomFieldValue

- `name` (string, required) — The display name of the custom field.
- `kind` (enum, required) — The type of the custom field.
  - Allowed values: `string`, `integer`, `number`, `boolean`, `date`, `datetime`, `list`
- `value` (string, optional) — The formatted value of the custom field. The actual JSON type depends on the kind: - string: the value as a string - integer, number: the value as a number (JSON number type) - boolean: true or false (JSON boolean type) - date: formatted date string (e.g., "Jan 15, 2024") - datetime: formatted date and time string (e.g., "Jan 15, 2024 3:45 PM") - list: comma-separated values as a string

> Build your audience with beehiiv's API and SDKs. Create new subscribers and posts, get real-time notifications of subscription activity, and more.