연락처 만들기
워크스페이스 주소록에 주소 하나를 저장합니다. 주소가 곧 식별자이므로 고를 id도 없고 응답에도 id가 없습니다. 주소는 앞뒤 공백을 제거하고 소문자로 바꾼 뒤 저장되며, 연락처는 `source`가 `manual`로 저장됩니다. 새 연락처는 저장되는 시점에 내장된 기본 오디언스에 들어가고, `audienceIds`에 지정한 오디언스에도 함께 들어갑니다.
본인 키로 워크스페이스에 실제 호출을 실행합니다.
POST /contacts
워크스페이스 주소록에 주소 하나를 저장합니다. 주소가 곧 식별자이므로 고를 id도 없고 응답에도 id가 없습니다. 주소는 앞뒤 공백을 제거하고 소문자로 바꾼 뒤 저장되며, 연락처는 source가 manual로 저장됩니다. 새 연락처는 저장되는 시점에 내장된 기본 오디언스에 들어가고, audienceIds에 지정한 오디언스에도 함께 들어갑니다.
예시
contacts:write가 필요합니다. audienceIds를 보내려면 audiences:write도 필요합니다.
curl -X POST "$OE/contacts" -H "$AUTH" -H 'content-type: application/json' -d '{ "email": "[email protected]", "name": "Grace Hopper", "notes": "Met at the compiler workshop"}'{ "object": "contact", "email": "[email protected]", "name": "Grace Hopper", "source": "manual", "notes": "Met at the compiler workshop", "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" } ]}이미 주소록에 있는 주소는 병합되지 않고 409 contact_exists가 됩니다. 재시도가 누군가 앱에서 고쳐 놓은 이름을 조용히 덮어쓰는 일을 막기 위해서입니다. 대신 해당 행을 읽고 PATCH 하세요.
lastSeenAt은 앱 작성기에서 그 주소로 메일이 나가기 전까지 null로 남습니다. source와 lastSeenAt은 서버의 것이며 본문에서 받아들이지 않습니다.
audienceIds에 이 워크스페이스에 존재하지 않는 오디언스 id가 있으면 404이며 아무것도 기록되지 않습니다.