Create a segment · Cueston Docs

POST/segmentsNeedscontent.edit

A saved audience any content can target. At most 200 per workspace (segment_limit).

Authorization

secretKey

headerAuthorizationBearer <sk_…>

A secret API key from Settings → API keys. It acts with its creator's role.

Request Body

application/json

body

name*string

1–100 characters, unique in the workspace (case-insensitive).

Lengthlength <= 100

description?|null

rules*

Who sees it: trait, behaviour and segment rules.

Response Body

Created

application/json

response

segment*

A saved, reusable audience.

Shell

curl -X POST 'https://app.cueston.com/api/segments' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Onboarding tour",
  "rules": {}
}'curl -X POST 'https://app.cueston.com/api/segments' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "Onboarding tour",
  "rules": {}
}'

Example ResponseSchema

JSON

{
  "segment": {
    "id": 42,
    "name": "Workspace admins",
    "description": "string",
    "rules": {
      "enabled": false,
      "matchType": "all",
      "rules": [
        {
          "id": "string",
          "attribute": "string",
          "operator": "equals",
          "value": "string",
          "key": "string"
        }
      ]
    },
    "createdBy": {
      "id": 42,
      "name": "Ada Lovelace"
    },
    "createdAt": "2026-10-26T09:30:00Z",
    "updatedAt": "2026-10-26T09:30:00Z",
    "usage": [
      {
        "type": "string",
        "id": 42,
        "name": "Onboarding tour"
      }
    ],
    "liveUsage": 0
  }
}{
  "segment": {
    "id": 42,
    "name": "Workspace admins",
    "description": "string",
    "rules": {
      "enabled": false,
      "matchType": "all",
      "rules": [
        {
          "id": "string",
          "attribute": "string",
          "operator": "equals",
          "value": "string",
          "key": "string"
        }
      ]
    },
    "createdBy": {
      "id": 42,
      "name": "Ada Lovelace"
    },
    "createdAt": "2026-10-26T09:30:00Z",
    "updatedAt": "2026-10-26T09:30:00Z",
    "usage": [
      {
        "type": "string",
        "id": 42,
        "name": "Onboarding tour"
      }
    ],
    "liveUsage": 0
  }
}