Aller à la documentation
API

Lister les contacts d'une audience

Les contacts eux-mêmes plutôt que des enregistrements d'appartenance, dans le même ordre que la liste des contacts : les plus récemment vus d'abord, et en dernier les contacts à qui rien n'a jamais été envoyé. `limit` monte jusqu'à 200 et vaut 50 par défaut. Lire l'audience par défaut ici renvoie tout le carnet d'adresses.

GETapi.openemail.uk/audiences/{id}/contacts

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

GET /audiences/{id}/contacts

Les contacts eux-mêmes plutôt que des enregistrements d'appartenance, dans le même ordre que la liste des contacts : les plus récemment vus d'abord, et en dernier les contacts à qui rien n'a jamais été envoyé. limit monte jusqu'à 200 et vaut 50 par défaut. Lire l'audience par défaut ici renvoie tout le carnet d'adresses.

Exemple

Nécessite audiences:read seul, sans contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Réponse
{  "object": "list",  "data": [    {      "object": "contact",      "email": "[email protected]",      "name": "Grace Hopper",      "source": "manual",      "notes": null,      "lastSeenAt": null,      "createdAt": "2026-09-18T09:00:00.000Z",      "updatedAt": "2026-09-18T09:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null,  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71"}

Une clé qui détient audiences:read lit les adresses d'une audience sans détenir contacts:read. Émettez-la en connaissance de cause.

Un contact qui n'appartient à aucune de vos propres audiences reste dans l'audience par défaut : rien dans le carnet n'est donc invisible pour cette route.