API

오디언스의 연락처 목록 조회

멤버십 레코드가 아니라 연락처 자체를, 연락처 목록과 동일한 순서로 반환합니다. 가장 최근에 확인된 순이며, 한 번도 메일을 보낸 적 없는 연락처가 마지막에 옵니다. `limit`은 최대 200까지이며 기본값은 50입니다. 여기서 기본 오디언스를 읽으면 주소록 전체가 반환됩니다.

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

본인 키로 워크스페이스에 실제 호출을 실행합니다.

GET /audiences/{id}/contacts

멤버십 레코드가 아니라 연락처 자체를, 연락처 목록과 동일한 순서로 반환합니다. 가장 최근에 확인된 순이며, 한 번도 메일을 보낸 적 없는 연락처가 마지막에 옵니다. limit은 최대 200까지이며 기본값은 50입니다. 여기서 기본 오디언스를 읽으면 주소록 전체가 반환됩니다.

예시

contacts:read 없이 audiences:read만 있으면 됩니다.

curl

curl "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts?limit=50" -H "$AUTH"

응답

{  "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"}

audiences:read를 가진 키는 contacts:read 없이도 오디언스 안의 주소를 읽습니다. 발급할 때 그 점을 염두에 두세요.

직접 만든 어떤 오디언스에도 속하지 않은 연락처라도 기본 오디언스에는 들어 있으므로, 주소록의 무엇도 이 라우트에서 보이지 않는 일은 없습니다.