Audiences

Create an audience

POST/v1/audiencesrequires campaign:write

Requestcurl -X POST https://api.transmit.dev/v1/audiences \
  -H "Authorization: Bearer tr_v2_…" \
  -H "Content-Type: application/json" \
  -d '{
       "name": "…"
     }'

Body

Field	Type	Notes
`name` required	`string`	1–200 characters
`description`	`string`	at most 1000 characters
`contact_ids`	`string[]`	at most 100000. defaults to []

Responses

Status	Meaning
`201`	The created audience
`401`	The API key is missing, malformed, expired or revoked
`403`	The API key lacks the `campaign:write` scope
`422`	A contact id does not belong to your organization

Every response body is described in the OpenAPI spec, which this page is generated from.