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

# Segments

> 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

- Segments [Create segment](https://developers.beehiiv.com/api-reference/segments/create.md)
- Segments [List segments <Badge intent="info" minimal outlined>OAuth Scope: segments:read</Badge>](https://developers.beehiiv.com/api-reference/segments/index.md)
- Segments [Get segment <Badge intent="info" minimal outlined>OAuth Scope: segments:read</Badge>](https://developers.beehiiv.com/api-reference/segments/show.md)
- Segments [Recalculate segment <Badge intent="info" minimal outlined>OAuth Scope: segments:write</Badge>](https://developers.beehiiv.com/api-reference/segments/recalculate.md)
- Segments [List segment subscribers <Badge intent="info" minimal outlined>OAuth Scope: segments:read</Badge>](https://developers.beehiiv.com/api-reference/segments/list-members.md)
- Segments [List segment subscriber IDs <Badge intent="info" minimal outlined>OAuth Scope: segments:read</Badge>](https://developers.beehiiv.com/api-reference/segments/expand-results.md)
- Segments [Delete segment <Badge intent="info" minimal outlined>OAuth Scope: segments:write</Badge>](https://developers.beehiiv.com/api-reference/segments/delete.md)

## OpenAPI Specification

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