Skip to main content
POST
Create segment

Authorizations

Authorization
string
header
required

API Key authentication. Secret keys (sk_*) are required for all endpoints except /v1/track. Public keys (pk_*) only work with the /v1/track endpoint for client-side event tracking. Workspaces can have multiple active keys, and sender-domain operations enforce per-key domain scope when configured.

Body

application/json
name
string
required
condition
object
required

Root segment condition structure using logical groups.

description
string
trackMembership
boolean

Track segment membership changes over time

Response

201 - application/json

Segment created

id
string
name
string
description
string | null
type
enum<string>
Available options:
DYNAMIC,
STATIC
condition
object | null

Root segment condition structure using logical groups.

trackMembership
boolean
memberCount
integer
projectId
string
createdAt
string<date-time>
updatedAt
string<date-time>