Zur Dokumentation springen
API

Die Kontakte einer Audience auflisten

Die Kontakte selbst statt der Mitgliedschaftsdatensätze, in derselben Reihenfolge wie die Kontaktliste: zuletzt gesehene zuerst, Kontakte, an die nie Mail ging, zuletzt. `limit` reicht bis 200, Standardwert ist 50. Wer hier die Standard-Audience liest, erhält das gesamte Adressbuch.

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

Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.

GET /audiences/{id}/contacts

Die Kontakte selbst statt der Mitgliedschaftsdatensätze, in derselben Reihenfolge wie die Kontaktliste: zuletzt gesehene zuerst, Kontakte, an die nie Mail ging, zuletzt. limit reicht bis 200, Standardwert ist 50. Wer hier die Standard-Audience liest, erhält das gesamte Adressbuch.

Beispiel

Erfordert allein audiences:read, ohne contacts:read.

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

Ein Schlüssel mit audiences:read liest die Adressen einer Audience, ohne contacts:read zu besitzen. Vergeben Sie ihn bewusst.

Ein Kontakt, der in keiner Ihrer eigenen Audiences steht, gehört trotzdem zur Standard-Audience; nichts im Adressbuch bleibt dieser Route also verborgen.