Create Audience

posthttps://db.fullvision.io/v1/audiences

Returns the stored audience and its id.

Use it when you have a rule set that compiles cleanly and want FullVision to keep the segment up to date from now on. Nothing is delivered anywhere until you attach a destination.

Create a new audience. The criteria JSON is validated and compiled; if any leaf references an unknown field, op, or violates the anchored-negation rule, the call is rejected with 422 and a list of AudienceCriteriaError items before any row is written.

Authorization

AuthorizationBearer <token>

API key as Bearer token

In: header

Request Body

application/json

name*string

Unique per workspace.

Length1 <= length <= 128

criteria_json*

Top-level audience criteria. The compiler walks root and emits one CH SELECT DISTINCT person_id query.

refresh_interval_sec?integer

Refresh cadence. 0 = never refresh on a fixed cadence (still gets the daily safety refresh).

Range0 <= value

Default3600

Responses

Created. Returns the new id only — fetch GET /v1/audiences/{id} for the full record.

id*string

Formatuuid

workspace_id*string

Formatuuid

created_at*string

Formatdate-time

post/v1/audiences

curl -X POST "https://db.fullvision.io/v1/audiences" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "criteria_json": {      "version": 1,      "root": {        "op": "and",        "children": [          null        ]      }    }  }'

Example Request Body

json

{  "name": "string",  "criteria_json": {    "version": 1,    "root": {      "op": "and",      "children": [        null      ]    }  }}

Example Responses

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9",  "created_at": "2019-08-24T14:15:22Z"}

application/json