API

Update an audience

A partial update. A field you leave out keeps its stored value and an explicit `null` clears it. The built-in default audience can be renamed and described like any other, and renaming it changes neither `builtin` nor what it holds.

PATCHapi.openemail.uk/audiences/{id}

Runs the real call against your workspace, with your own key.

PATCH /audiences/{id}

A partial update. A field you leave out keeps its stored value and an explicit null clears it. The built-in default audience can be renamed and described like any other, and renaming it changes neither builtin nor what it holds.

Example

Needs audiences:write.

curl

curl -X PATCH "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Release notes"}'

Response

{  "object": "audience",  "id": "aud_4c1b8e2a7d9f05c36b4e8a71",  "name": "Release notes",  "description": "Customers who asked to hear about releases",  "builtin": null,  "contactCount": 3,  "createdAt": "2026-09-18T09:10:00.000Z",  "updatedAt": "2026-09-18T09:22:00.000Z"}

builtin cannot be set, moved or cleared from here.

Renaming moves nobody. The contacts stay in the audience under its new name, and the id never changes.