API
오디언스 목록 조회
오디언스는 이 워크스페이스에 속한, 이름이 붙은 연락처 목록입니다. 모든 연락처는 생성되는 순간부터 내장된 기본 오디언스에 들어가며, 그 행을 가려내는 것이 `builtin`입니다. 나머지는 직접 만들고 채우고 삭제할 수 있습니다. 기본 오디언스가 먼저 오고, 그다음은 최신순입니다. 이 버전은 목록을 관리할 뿐 목록으로 아무것도 발송하지 않으므로, 브로드캐스트 엔드포인트를 찾아다닐 필요는 없습니다.
GETapi.openemail.uk/audiences
본인 키로 워크스페이스에 실제 호출을 실행합니다.
GET /audiences
오디언스는 이 워크스페이스에 속한, 이름이 붙은 연락처 목록입니다. 모든 연락처는 생성되는 순간부터 내장된 기본 오디언스에 들어가며, 그 행을 가려내는 것이 builtin입니다. 나머지는 직접 만들고 채우고 삭제할 수 있습니다. 기본 오디언스가 먼저 오고, 그다음은 최신순입니다. 이 버전은 목록을 관리할 뿐 목록으로 아무것도 발송하지 않으므로, 브로드캐스트 엔드포인트를 찾아다닐 필요는 없습니다.
예시
audiences:read가 필요합니다. limit은 최대 100까지이며 기본값은 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}이름이 아니라 builtin으로 분기하세요. 기본 오디언스는 누구나 이름을 바꿀 수 있고, 바뀌는 것은 이름뿐입니다.
기본 오디언스는 첫 조회 시점에 확정되므로, 오디언스를 한 번도 만든 적 없는 워크스페이스도 정확히 한 행을 반환합니다.
contactCount는 조회 시점에 집계되므로, 생성 전후로 두 번 읽으면 하나만큼 어긋납니다. 이름은 고유하지 않으니 이름이 아니라 id를 저장하세요.