---
title: "Create Segment"
method: POST
path: "/v1/segment/"
---

# Create Segment

`POST /v1/segment/`

## Request body

- object
  - `Name` string, required — The human-friendly name of the segment.
  - `Source` string — Where the segment came from.
  - `Reach` object — The estimated reach of the segment for all time and the last 4 weeks.
    - `all_time` integer
    - `28d` integer
  - `Description` string — An extended human-friendly description of the segment.
  - `Category` string — The category a segment belongs to.
  - `Advertisers` object[] — A list of Advertisers that have access to the Segment.
    - `AdvertiserId` integer

## Response `200`

200

- object
  - `Id` integer
  - `Source` string
  - `Name` string
  - `Reach` object
    - `all_time` integer
    - `28d` integer
  - `Description` string
  - `Category` string
  - `IsDeleted` boolean

## Other responses

- `400` — 400

---

[API](https://skmtc.net/kevel/apis/engine-apis.md) · [All operations](https://skmtc.net/kevel/apis/engine-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kevel/engine-apis/versions/0ca55f45aa7d/schema)