API

오디언스에 연락처 추가

이미 워크스페이스 주소록에 있는 주소를 받아 멤버십을 반환하며, 그 멤버십이 가리키는 연락처도 함께 돌려줍니다. 오디언스와 연락처 조합당 멤버십은 하나뿐이므로, 이미 오디언스에 있는 사람을 추가하면 두 번째 멤버십을 만들거나 실패하는 대신 원래의 `addedAt`과 함께 `200`을 응답합니다. 덕분에 이 호출은 안전하게 재시도할 수 있습니다.

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

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

POST /audiences/{id}/contacts

이미 워크스페이스 주소록에 있는 주소를 받아 멤버십을 반환하며, 그 멤버십이 가리키는 연락처도 함께 돌려줍니다. 오디언스와 연락처 조합당 멤버십은 하나뿐이므로, 이미 오디언스에 있는 사람을 추가하면 두 번째 멤버십을 만들거나 실패하는 대신 원래의 addedAt과 함께 200을 응답합니다. 덕분에 이 호출은 안전하게 재시도할 수 있습니다.

예시

audiences:write가 필요합니다.

curl

curl -X POST "$OE/audiences/aud_4c1b8e2a7d9f05c36b4e8a71/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{  "email": "[email protected]"}'

응답

{  "object": "audience_member",  "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71",  "addedAt": "2026-09-18T09:30:00.000Z",  "contact": {    "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"  }}

연락처가 아닌 주소는 그 자리에서 생성되지 않고 422 contact_not_found로 거부됩니다. 먼저 POST /contacts로 저장하세요.

검사하는 스코프는 audiences:write 하나뿐입니다. 연락처를 목록에 넣는 것은 연락처 자체에 대한 쓰기가 아닙니다.

연락처 하나당 호출 한 번입니다. 이 버전에는 일괄 추가가 없으며, 나중에 연락처를 삭제하면 이 멤버십도 함께 사라집니다.