Zur Dokumentation springen
API

Audiences auflisten

Eine Audience ist eine benannte Kontaktliste in diesem Workspace. Jeder Kontakt gehört vom Moment seiner Entstehung an zur eingebauten Standard-Audience, und `builtin` ist es, was diese Zeile kennzeichnet; alle übrigen legen Sie selbst an, befüllen und löschen sie. Die Standard-Audience steht an erster Stelle, danach folgen die übrigen, neueste zuerst. Diese Version verwaltet Listen und versendet nichts an sie; nach einem Broadcast-Endpunkt muss man also gar nicht erst suchen.

GETapi.openemail.uk/audiences

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

GET /audiences

Eine Audience ist eine benannte Kontaktliste in diesem Workspace. Jeder Kontakt gehört vom Moment seiner Entstehung an zur eingebauten Standard-Audience, und builtin ist es, was diese Zeile kennzeichnet; alle übrigen legen Sie selbst an, befüllen und löschen sie. Die Standard-Audience steht an erster Stelle, danach folgen die übrigen, neueste zuerst. Diese Version verwaltet Listen und versendet nichts an sie; nach einem Broadcast-Endpunkt muss man also gar nicht erst suchen.

Beispiel

Erfordert audiences:read. limit reicht bis 100, Standardwert ist 25.

curl
curl "$OE/audiences" -H "$AUTH"
Antwort
{  "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}

Verzweigen Sie über builtin, nicht über den Namen. Die Standard-Audience kann von jedem umbenannt werden, und ihr Name ist das Einzige an ihr, das sich ändert.

Die Standard-Audience wird beim ersten Lesen aufgelöst; ein Workspace, in dem nie eine Audience angelegt wurde, listet daher trotzdem genau eine Zeile.

contactCount wird im Moment des Lesens gezählt; zwei Lesevorgänge vor und nach einem Anlegen weichen daher um eins voneinander ab. Namen sind nicht eindeutig; speichern Sie deshalb ids statt Namen.