Create an audience
Makes a new, empty audience and returns it with its id. `name` is trimmed and must then be 1 to 120 characters. `description` is optional free text for whoever reads the list later. Names are not checked for duplicates, because an audience is addressed by its id.
Runs the real call on your workspace.
POST /audiences
Makes a new, empty audience and returns it with its id. name is trimmed and must then be 1 to 120 characters. description is optional free text for whoever reads the list later. Names are not checked for duplicates, because an audience is addressed by its id.
Example
Needs audiences:write.
curl -X POST "$OE/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Product updates", "description": "Customers who asked to hear about releases"}'{ "object": "audience", "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "description": "Customers who asked to hear about releases", "builtin": null, "contactCount": 0, "lastContactAt": null, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z"}builtin is never accepted from the body. Exactly one row per workspace carries it and the server owns that row.
A workspace holds 100 audiences by default. The next one is refused with 422 workspace_limit_reached, and support can raise the limit for a workspace that needs more.
Fill it with the add routes, one contact at a time or up to 200 in one call, for contacts already in the book, or with the import route, which creates the contacts it does not find.