Aller à la documentation
API

Créer une audience

Crée une audience vide et la renvoie avec son id. `name` est débarrassé de ses espaces de tête et de fin et doit ensuite faire de 1 à 120 caractères. `description` est un texte libre facultatif, destiné à qui lira la liste plus tard. Les noms ne sont pas contrôlés en double, car une audience est désignée par son id.

POSTapi.openemail.uk/audiences

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

POST /audiences

Crée une audience vide et la renvoie avec son id. name est débarrassé de ses espaces de tête et de fin et doit ensuite faire de 1 à 120 caractères. description est un texte libre facultatif, destiné à qui lira la liste plus tard. Les noms ne sont pas contrôlés en double, car une audience est désignée par son id.

Exemple

Nécessite audiences:write.

curl
curl -X POST "$OE/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Product updates",  "description": "Customers who asked to hear about releases"}'
Réponse
{  "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 n'est jamais accepté depuis le corps de la requête. Exactement une ligne par espace de travail le porte, et cette ligne appartient au serveur.

Un espace de travail contient au plus 100 audiences. La suivante est refusée avec 422 audience_limit_reached sur name.

Remplissez-la avec la route d'ajout, un contact à la fois, et les contacts doivent déjà se trouver dans le carnet.