> ## Documentation Index
> Fetch the complete documentation index at: https://developers.aimtell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Segment

> Create a NEW Segment



## OpenAPI

````yaml /api-reference/segments-openapi.json post /prod/segments/
openapi: 3.1.0
info:
  title: segmentation
  version: '1.1'
servers:
  - url: https://api.aimtell.com
security:
  - sec0: []
tags:
  - name: Segments
    description: Audience segmentation
  - name: Subscribers
    description: Subscriber management and tracking
paths:
  /prod/segments/:
    post:
      tags:
        - Segments
      summary: Create Segment
      description: Create a NEW Segment
      operationId: create-segment
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - idSite
              properties:
                idSite:
                  type: string
                  description: Site ID
                name:
                  type: string
                  description: Name of Segment
                  default: ''
                definition:
                  type: string
                  description: Definition
                  default: ''
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    result: success
                    message: Successfully created
                    id: 88
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value:
                    result: error
                    message: 'Error #139.'
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      name: X-Authorization-Api-Key
      in: header
      x-default: ''

````