Skip to main content
POST
/
v0
/
segments
curl --request POST \
  --url https://api.formo.so/v0/segments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "High-value mobile users",
  "filterSets": [
    "device::equals::mobile",
    "net_worth_usd::greaterOrEqual::10000",
    "utm_source::equals::paid_ads"
  ]
}
'
{
  "id": "<string>",
  "title": "<string>",
  "projectId": "<string>",
  "filterSet": [
    "<string>"
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.formo.so/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Workspace API key (e.g. formo_xxx). Create one in the Formo dashboard under Team Settings > API Keys.

Body

application/json
​
title
string
required
Minimum string length: 1
​
filterSets
string[]
required
Minimum array length: 1

Response

200 - application/json

Segment created

​
id
string
required
​
title
string
required
​
projectId
string
​
filterSet
string[]