Saltar para a documentação
API

Listar os contactos de uma audiência

Os próprios contactos, em vez de registos de associação, pela mesma ordem da lista de contactos: os vistos mais recentemente primeiro, com os contactos a quem nunca foi enviado correio no fim. `limit` vai até 200 e assume 50 por omissão. Ler aqui a audiência predefinida devolve o livro de endereços completo.

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

Executa a chamada real contra o seu espaço de trabalho, com a sua própria chave.

GET /audiences/{id}/contacts

Os próprios contactos, em vez de registos de associação, pela mesma ordem da lista de contactos: os vistos mais recentemente primeiro, com os contactos a quem nunca foi enviado correio no fim. limit vai até 200 e assume 50 por omissão. Ler aqui a audiência predefinida devolve o livro de endereços completo.

Exemplo

Requer apenas audiences:read, sem contacts:read.

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

Uma chave com audiences:read lê os endereços de uma audiência sem ter contacts:read. Emita-a de forma deliberada.

Um contacto que não esteja em nenhuma audiência sua continua a estar na predefinida, pelo que nada no livro fica invisível para esta rota.