Een audience aanmaken
Maakt een nieuwe, lege audience aan en geeft die terug met zijn id. `name` wordt getrimd en moet daarna 1 tot 120 tekens lang zijn. `description` is optionele vrije tekst voor wie de lijst later leest. Namen worden niet op duplicaten gecontroleerd, omdat een audience via zijn id wordt aangesproken.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
POST /audiences
Maakt een nieuwe, lege audience aan en geeft die terug met zijn id. name wordt getrimd en moet daarna 1 tot 120 tekens lang zijn. description is optionele vrije tekst voor wie de lijst later leest. Namen worden niet op duplicaten gecontroleerd, omdat een audience via zijn id wordt aangesproken.
Voorbeeld
Vereist 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 wordt nooit uit de body geaccepteerd. Precies één rij per workspace draagt het, en die rij is van de server.
Een workspace bevat maximaal 100 audiences. De volgende wordt geweigerd met 422 audience_limit_reached op name.
Vul hem via de toevoegroute, één contact tegelijk, en de contacten moeten al in het adresboek staan.