---
title: "Create a segment"
canonical: https://docs.mentio.dev/api/segments/create-segment
markdown: https://docs.mentio.dev/api/segments/create-segment.mdx
---

# Create a segment

`POST /v1/segments`

## Body

- `name` (required): string
- `description`: string
- `filter`: object

## Responses

- 201: The saved segment, with its current size
- 400: Invalid body
- 401: Missing or invalid API key
- 409: A segment with this name already exists

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx