Přejít na dokumentaci
API

Seznam publik

Publikum je pojmenovaný seznam kontaktů v tomto workspace. Každý kontakt je od okamžiku svého vzniku ve vestavěném výchozím publiku a `builtin` je to, co tento řádek označuje; zbytek je na vás – vytvářet, plnit a mazat. Výchozí publikum je první, pak následuje zbytek od nejnovějšího. Tato verze seznamy spravuje a nic na ně neodesílá, takže žádný endpoint pro hromadnou rozesílku nehledejte.

GETapi.openemail.uk/audiences

Spustí skutečné volání proti vašemu pracovnímu prostoru, s vaším vlastním klíčem.

GET /audiences

Publikum je pojmenovaný seznam kontaktů v tomto workspace. Každý kontakt je od okamžiku svého vzniku ve vestavěném výchozím publiku a builtin je to, co tento řádek označuje; zbytek je na vás – vytvářet, plnit a mazat. Výchozí publikum je první, pak následuje zbytek od nejnovějšího. Tato verze seznamy spravuje a nic na ně neodesílá, takže žádný endpoint pro hromadnou rozesílku nehledejte.

Příklad

Vyžaduje audiences:read. limit jde až na 100 a výchozí hodnota je 25.

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

Větvěte podle builtin, ne podle názvu. Výchozí publikum může kdokoli přejmenovat a jeho název je jediné, co se na něm mění.

Výchozí publikum se vyřeší při prvním čtení, takže i workspace, který nikdy žádné publikum nevytvořil, vypíše přesně jeden řádek.

contactCount se počítá v okamžiku čtení, takže dvě čtení před vytvořením a po něm se liší o jedna. Názvy nejsou unikátní, proto si ukládejte id, ne názvy.