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

# Newsletter List 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

- Newsletter List Subscriptions [Create newsletter list subscription <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/create.md)
- Newsletter List Subscriptions [List newsletter list subscriptions <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:read</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/index.md)
- Newsletter List Subscriptions [Get newsletter list subscription <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:read</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/show.md)
- Newsletter List Subscriptions [Update newsletter list subscription <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/update.md)
- Newsletter List Subscriptions [Update newsletter list subscription by subscription ID <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/update-by-subscription-id.md)
- Newsletter List Subscriptions [Create newsletter list subscriber import <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/create-import.md)
- Newsletter List Subscriptions [Get newsletter list subscriber import <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:read</Badge>](https://developers.beehiiv.com/api-reference/newsletter-list-subscriptions/get-import.md)

## OpenAPI Specification

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