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

# Posts

> 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

- Posts [Create post <Badge intent="info" minimal outlined>OAuth Scope: posts:write</Badge>](https://developers.beehiiv.com/api-reference/posts/create.md)
- Posts [Update post <Badge intent="info" minimal outlined>OAuth Scope: posts:write</Badge>](https://developers.beehiiv.com/api-reference/posts/update.md)
- Posts [List posts <Badge intent="info" minimal outlined>OAuth Scope: posts:read</Badge>](https://developers.beehiiv.com/api-reference/posts/index.md)
- Posts [Get aggregate stats <Badge intent="info" minimal outlined>OAuth Scope: posts:read</Badge>](https://developers.beehiiv.com/api-reference/posts/aggregate-stats.md)
- Posts [Get post <Badge intent="info" minimal outlined>OAuth Scope: posts:read</Badge>](https://developers.beehiiv.com/api-reference/posts/show.md)
- Posts [Delete post <Badge intent="info" minimal outlined>OAuth Scope: posts:write</Badge>](https://developers.beehiiv.com/api-reference/posts/delete.md)
- Posts [Send test email <Badge intent="info" minimal outlined>OAuth Scope: posts</Badge>](https://developers.beehiiv.com/api-reference/posts/test-send.md)
- Posts [Generate post preview URL <Badge intent="info" minimal outlined>OAuth Scope: posts:read</Badge>](https://developers.beehiiv.com/api-reference/posts/preview.md)

## OpenAPI Specification

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