Audiences opvragen
Een audience is een benoemde lijst met contacten in deze workspace. Elk contact zit vanaf het moment dat het bestaat in de ingebouwde standaard-audience, en `builtin` is wat die rij benoemt; de rest maak, vul en verwijder je zelf. De standaard-audience komt eerst, daarna de rest met de nieuwste eerst. Deze versie beheert lijsten en verstuurt er niets naartoe, dus er is geen broadcast-endpoint om naar te zoeken.
Voert de echte aanroep uit op je workspace, met je eigen sleutel.
GET /audiences
Een audience is een benoemde lijst met contacten in deze workspace. Elk contact zit vanaf het moment dat het bestaat in de ingebouwde standaard-audience, en builtin is wat die rij benoemt; de rest maak, vul en verwijder je zelf. De standaard-audience komt eerst, daarna de rest met de nieuwste eerst. Deze versie beheert lijsten en verstuurt er niets naartoe, dus er is geen broadcast-endpoint om naar te zoeken.
Voorbeeld
Vereist audiences:read. limit gaat tot 100 en is standaard 25.
curl "$OE/audiences" -H "$AUTH"{ "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}Vertak op builtin in plaats van op de naam. De standaard-audience kan door iedereen worden hernoemd, en de naam is het enige eraan dat verandert.
De standaard-audience wordt bij de eerste leesactie bepaald, dus een workspace die nooit een audience heeft gemaakt, toont toch precies één rij.
contactCount wordt geteld op het moment van lezen, dus twee leesacties rond een aanmaak verschillen één. Namen zijn niet uniek, dus sla ids op in plaats van namen.