---
title: "Create segment"
method: POST
path: "/segment"
tags: ["Segments"]
---

# Create segment

`POST /segment`

## Request

- Base URL: `https://api.lytics.io/v2`
- URL: `https://api.lytics.io/v2/segment`
- Auth: API key in header `Authorization`

Create a segment

## Query parameters

- `account_id` string

## Request body `*/*`

- ModelsSegment
  - `account_id` string
  - `aid` integer
  - `ast` ModelsExpr
    - `args` ModelsExpr[]
    - `ident` string
    - `op` string
    - `val` string
  - `author_id` string
  - `category` string
  - `created` string
  - `datemath_calc` boolean
  - `deleted` boolean
  - `description` string
  - `field_changes_fields` string[]
  - `fields` string[]
  - `forward_datemath` boolean
  - `groups` string[]
  - `id` string
  - `identities` string[]
  - `includes` string[]
  - `invalid` boolean
  - `invalid_reason` string
  - `is_public` boolean
  - `kind` string
  - `name` string
  - `public_name` string
  - `ql_resolved` string
  - `save_hist` boolean
  - `schedule_exit` boolean
  - `segment_ql` string
  - `size` integer
  - `slug_name` string
  - `table` string
  - `tags` string[]
  - `updated` string
  - `withs_ql` string

## Response `201`

Segment Response

- object
  - `_meta` object: Response Metadata
  - `data` object: Response Payload
    - `account_id` string
    - `aid` integer
    - `ast` ModelsExpr
      - `args` ModelsExpr[]
      - `ident` string
      - `op` string
      - `val` string
    - `author_id` string
    - `category` string
    - `created` string
    - `datemath_calc` boolean
    - `deleted` boolean
    - `description` string
    - `field_changes_fields` string[]
    - `fields` string[]
    - `forward_datemath` boolean
    - `groups` string[]
    - `id` string
    - `identities` string[]
    - `includes` string[]
    - `invalid` boolean
    - `invalid_reason` string
    - `is_public` boolean
    - `kind` string
    - `name` string
    - `public_name` string
    - `ql_resolved` string
    - `save_hist` boolean
    - `schedule_exit` boolean
    - `segment_ql` string
    - `size` integer
    - `slug_name` string
    - `table` string
    - `tags` string[]
    - `updated` string
    - `withs_ql` string
  - `request_id` string
  - `status` integer: HTTP Status Code

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error

## Changes

- **2026-11-03** `d8e975057aec`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lytics/apis/lytics-api/changes/segment/post.md)

---

[API](https://skmtc.dev/lytics/apis/lytics-api.md) - [All operations](https://skmtc.dev/lytics/apis/lytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lytics/apis/lytics-api/revisions/d8e975057aec?raw)