Eine Audience anlegen
Legt eine neue, leere Audience an und gibt sie mit ihrer id zurück. `name` wird getrimmt und muss danach 1 bis 120 Zeichen lang sein. `description` ist optionaler Freitext für alle, die die Liste später lesen. Namen werden nicht auf Dubletten geprüft, denn eine Audience wird über ihre id angesprochen.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /audiences
Legt eine neue, leere Audience an und gibt sie mit ihrer id zurück. name wird getrimmt und muss danach 1 bis 120 Zeichen lang sein. description ist optionaler Freitext für alle, die die Liste später lesen. Namen werden nicht auf Dubletten geprüft, denn eine Audience wird über ihre id angesprochen.
Beispiel
Erfordert 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, "createdAt": "2026-09-18T09:10:00.000Z", "updatedAt": "2026-09-18T09:10:00.000Z"}builtin wird niemals aus dem Body übernommen. Genau eine Zeile pro Workspace trägt es, und diese Zeile gehört dem Server.
Ein Workspace fasst höchstens 100 Audiences. Die nächste wird mit 422 audience_limit_reached auf name abgelehnt.
Befüllen Sie sie über die Add-Route, einen Kontakt nach dem anderen; die Kontakte müssen bereits im Adressbuch stehen.