API
연락처의 오디언스 지정
연락처 하나가 어떤 오디언스에 속할지 한 번의 호출로 정확히 지정합니다. 연락처는 `audienceIds`에 있는 오디언스 중 아직 속하지 않은 곳에 모두 들어가고, 나머지 오디언스에서는 모두 빠집니다. 기본 오디언스는 항상 유지되므로, 빈 목록을 보내면 연락처는 기본 오디언스에만 남습니다.
PUTapi.openemail.uk/contacts/{email}/audiences
본인 키로 워크스페이스에 실제 호출을 실행합니다.
PUT /contacts/{email}/audiences
연락처 하나가 어떤 오디언스에 속할지 한 번의 호출로 정확히 지정합니다. 연락처는 audienceIds에 있는 오디언스 중 아직 속하지 않은 곳에 모두 들어가고, 나머지 오디언스에서는 모두 빠집니다. 기본 오디언스는 항상 유지되므로, 빈 목록을 보내면 연락처는 기본 오디언스에만 남습니다.
예시
연락처가 아니라 멤버십을 쓰므로 audiences:write가 필요합니다. @는 URL 인코딩하세요. audienceIds에는 ID를 최대 100개까지 넣을 수 있습니다.
curl -X PUT "$OE/contacts/grace%40example.com/audiences" -H "$AUTH" -H 'content-type: application/json' -d '{ "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"]}'{ "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", "audiences": [ { "id": "aud_9f2c4b7e1a0d63d84c5f2e7b", "name": "All contacts", "builtin": "default" }, { "id": "aud_4c1b8e2a7d9f05c36b4e8a71", "name": "Product updates", "builtin": null } ]}연락처가 이미 있어야 합니다. 주소록에 없는 주소는 404 contact_not_found가 됩니다. audienceIds도 받는 POST /contacts로 먼저 만드세요.
이 워크스페이스의 어떤 오디언스도 가리키지 않는 ID는 404 audience_not_found가 되고 아무것도 바뀌지 않으므로, 오타 때문에 누군가 조용히 목록에서 빠지는 일은 없습니다. 같은 호출을 다시 보내도 아무것도 바뀌지 않습니다.
응답은 GET /contacts/{email}이 반환하는 것과 같은 연락처이며, 변경 후 속한 모든 오디언스를 담고 있습니다.