Przejdź do dokumentacji
API

Lista kontaktów w grupie odbiorców

Same kontakty, a nie rekordy przynależności, w tej samej kolejności co lista kontaktów: najpierw ostatnio widziane, a na końcu kontakty, do których nigdy nie wysłano poczty. `limit` sięga 200, domyślnie 50. Odczyt domyślnej grupy odbiorców zwraca tutaj całą książkę adresową.

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

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

GET /audiences/{id}/contacts

Same kontakty, a nie rekordy przynależności, w tej samej kolejności co lista kontaktów: najpierw ostatnio widziane, a na końcu kontakty, do których nigdy nie wysłano poczty. limit sięga 200, domyślnie 50. Odczyt domyślnej grupy odbiorców zwraca tutaj całą książkę adresową.

Przykład

Wymaga samego audiences:read, bez contacts:read.

curl
curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"
Odpowiedź
{  "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"}

Klucz z audiences:read odczytuje adresy w grupie odbiorców, nie mając contacts:read. Wydawaj go świadomie.

Kontakt, który nie należy do żadnej z Twoich grup odbiorców, i tak jest w domyślnej, więc nic z książki adresowej nie pozostaje niewidoczne dla tego endpointu.