Crear una audiència
Crea una audiència nova i buida i la retorna amb el seu id. `name` es retalla i després ha de tenir entre 1 i 120 caràcters. `description` és text lliure opcional per a qui llegeixi la llista més endavant. Els noms no es comproven per duplicats, perquè una audiència s'adreça pel seu id.
Executa la crida real contra el teu espai de treball, amb la teva pròpia clau.
POST /audiences
Crea una audiència nova i buida i la retorna amb el seu id. name es retalla i després ha de tenir entre 1 i 120 caràcters. description és text lliure opcional per a qui llegeixi la llista més endavant. Els noms no es comproven per duplicats, perquè una audiència s'adreça pel seu id.
Exemple
Requereix 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 no s'accepta mai des del cos. Exactament una fila per espai de treball el porta i el servidor és l'amo d'aquesta fila.
Un espai de treball té com a màxim 100 audiències. La següent es rebutja amb 422 audience_limit_reached a name.
Omple-la amb la ruta d'alta, un contacte cada vegada, i els contactes ja han de ser a la llibreta.