BitelioBitelio

Create segment

Create a new audience segment

Path versioning. This resource is also reachable at the unversioned /segments, which is where it has always lived and which keeps working indefinitely — bitelio@0.1.0 calls it. Prefer /v1/segments: the /v1 prefix is the path that carries a version promise, and a future /v2 will be able to change shape without breaking anything written against this one.

POST
/v1/segments

Authorization

ApiKeyAuth

AuthorizationBearer <token>

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. The project is automatically derived from the key.

In: header

Request Body

application/json

name*string
filters*object

Filter conditions

trackMembership?boolean
Defaultfalse

Response Body

application/json

curl -X POST "https://api.bitelio.com/v1/segments" \  -H "Content-Type: application/json" \  -d '{    "name": "Premium Users",    "filters": {      "operator": "AND",      "conditions": [        {          "field": "data.plan",          "operator": "equals",          "value": "premium"        }      ]    },    "trackMembership": true  }'
{
  "id": "string",
  "name": "string",
  "filters": {},
  "trackMembership": true,
  "memberCount": 0
}