---
title: "Create segment"
method: POST
path: "/api-offers/segment"
tags: ["Segment"]
---

# Create segment

`POST /api-offers/segment`

## Request

- Base URL: `https://live.copilot.fabric.inc`
- URL: `https://live.copilot.fabric.inc/api-offers/segment`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/fabric/apis/offers-v2/docs/api-offers/segment/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a segment record.

## Headers

- `x-site-context` string, required

## Request body

- CreateSegmentRequest
  - `name` string, required: Name of segment
  - `value` string[], required: Array of segment value

## Response `200`

OK

- CreateSegmentResponse
  - `_id` string: fabric internal database ObjectId of the record
  - `segmentId` number: System generated unique ID of the segment
  - `name` string: Name of segment
  - `value` string[]: Array of segment value
  - `deleted` boolean: true: Segment is deleted<br /> false: Segment is not deleted
  - `createdAt` string, date-time: Creation date of the record
  - `updatedAt` string, date-time: Last updated date of the record

## Other responses

- `400`: Bad request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/fabric/apis/offers-v2.md) - [All operations](https://skmtc.dev/fabric/apis/offers-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/fabric/apis/offers-v2/revisions/da2bd742b9bc?raw)