Przejdź do dokumentacji
API

Lista grup odbiorców

Grupa odbiorców to nazwana lista kontaktów w tej przestrzeni roboczej. Każdy kontakt od chwili powstania należy do wbudowanej domyślnej grupy odbiorców, a wiersz tej grupy rozpoznaje `builtin`; resztę tworzysz, wypełniasz i usuwasz sam. Najpierw idzie domyślna grupa odbiorców, potem reszta od najnowszej. Ta wersja zarządza listami i niczego do nich nie wysyła, więc nie ma tu endpointu rozsyłki, którego można by szukać.

GETapi.openemail.uk/audiences

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

GET /audiences

Grupa odbiorców to nazwana lista kontaktów w tej przestrzeni roboczej. Każdy kontakt od chwili powstania należy do wbudowanej domyślnej grupy odbiorców, a wiersz tej grupy rozpoznaje builtin; resztę tworzysz, wypełniasz i usuwasz sam. Najpierw idzie domyślna grupa odbiorców, potem reszta od najnowszej. Ta wersja zarządza listami i niczego do nich nie wysyła, więc nie ma tu endpointu rozsyłki, którego można by szukać.

Przykład

Wymaga audiences:read. limit sięga 100, domyślnie 25.

curl
curl "$OE/audiences" -H "$AUTH"
Odpowiedź
{  "object": "list",  "data": [    {      "object": "audience",      "id": "aud_9f2c4b7e1a0d63d84c5f2e7b",      "name": "All contacts",      "description": null,      "builtin": "default",      "contactCount": 412,      "createdAt": "2026-08-01T10:00:00.000Z",      "updatedAt": "2026-08-01T10:00:00.000Z"    }  ],  "hasMore": false,  "nextCursor": null}

Rozgałęziaj kod na builtin, a nie na nazwie. Domyślną grupę odbiorców każdy może przemianować, a jej nazwa to jedyna rzecz, która się w niej zmienia.

Domyślna grupa odbiorców powstaje przy pierwszym odczycie, więc przestrzeń robocza, w której nigdy nie utworzono żadnej grupy, i tak wylistuje dokładnie jeden wiersz.

contactCount jest liczony w chwili odczytu, więc dwa odczyty po obu stronach utworzenia różnią się o jeden. Nazwy nie są unikalne, więc przechowuj id, a nie nazwy.