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

# Subscriptions

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


## API Docs

- Subscriptions [Create subscription <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:write</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/create.md)
- Subscriptions [List subscriptions <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:read</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/index.md)
- Subscriptions [Get subscription by email <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:read</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/get-by-email.md)
- Subscriptions [Get subscription by ID <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:read</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/get-by-id.md)
- Subscriptions [Update subscription by ID <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:write</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/put.md)
- Subscriptions [Update subscription by email <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:write</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/update-by-email.md)
- Subscriptions [Delete subscription <Badge intent="info" minimal outlined>OAuth Scope: subscriptions:write</Badge>](https://developers.beehiiv.com/api-reference/subscriptions/delete.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developers.beehiiv.com/api-reference/subscriptions/openapi.json)
- [OpenAPI YAML](https://developers.beehiiv.com/api-reference/subscriptions/openapi.yaml)