> 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-lists/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.beehiiv.com/_mcp/server.

# Newsletter Lists

> 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 Lists [List newsletter lists <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:read</Badge>](https://developers.beehiiv.com/api-reference/newsletter-lists/index.md)
- Newsletter Lists [Get newsletter list <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:read</Badge>](https://developers.beehiiv.com/api-reference/newsletter-lists/show.md)
- Newsletter Lists [Create newsletter list <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-lists/create.md)
- Newsletter Lists [Update newsletter list <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-lists/update.md)
- Newsletter Lists [Delete newsletter list <Badge intent="info" minimal outlined>OAuth Scope: newsletter_lists:write</Badge>](https://developers.beehiiv.com/api-reference/newsletter-lists/delete.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)