메인 콘텐츠로 건너뛰기
POST
curl
전화번호. +와 국가번호로 시작하는 번호는 그 국가로 저장됩니다. 010-2938-4756처럼 국가번호가 없는 한국 휴대전화 번호는 한국(+82) 번호로 저장됩니다. 국가 필드는 없으므로 다른 나라 번호는 +와 국가번호를 붙여 보내세요. 처음 본 날. firstSeenAt(RFC 3339, 미래가 아니어야 하며 2000-01-01 이후)을 보내면 연락처가 처음 본 날로 표시되는 날짜(예: 그 사람이 서비스에 가입한 날)를 정할 수 있습니다. 새 연락처와 이미 있는 연락처 모두에 적용되며, 보낼 때마다 저장된 날짜를 바꿉니다. 보내지 않으면 그대로 둡니다.

인증

Authorization
string
header
필수

Settings → Developers에서 발급한 키를 Authorization: Bearer dr_live_<12자리 16진수>_<64자리 16진수> 형태로 전송합니다. 키는 명시적인 범위를 가지며 — 각 엔드포인트에 필요한 범위가 해당 엔드포인트에 명시되어 있습니다. 전체 키는 발급 시점에 딱 한 번만 표시되며 다시 조회할 수 없습니다 — 이후에는 keyId 접두어만 표시됩니다. 폐기된 키는 바로 다음 요청부터 인증에 실패합니다.

헤더

Idempotency-Key
string
필수

이 시도를 구분하는, 클라이언트가 만든 고유 문자열(255자 이하). 위의 "멱등성"을 참고하세요.

Maximum string length: 255

본문

application/json
email
string
필수

연락처의 이메일 주소. 앞뒤 공백은 제거되고 소문자로 바뀝니다. ASCII 주소여야 합니다.

Maximum string length: 320
예시:

"person@example.com"

name
string | null

비어 있지 않으면 저장된 이름을 바꿉니다. 보내지 않거나 null, 빈 문자열이면 그대로 둡니다.

Maximum string length: 200
예시:

"Ada Lee"

company
string | null

비어 있지 않으면 저장된 회사명을 바꿉니다. 보내지 않거나 null, 빈 문자열이면 그대로 둡니다.

Maximum string length: 200
예시:

"Example Inc"

phone
string | null

비어 있지 않으면 저장된 전화번호를 바꿉니다. +와 국가번호로 시작하는 번호는 그 국가로 저장됩니다. 010-2938-4756처럼 국가번호가 없는 한국 휴대전화 번호는 한국(+82) 번호로 저장됩니다. 국가 필드는 없으므로 다른 나라 번호는 +와 국가번호를 붙여 보내세요. 해석할 수 없는 번호는 보낸 그대로 저장됩니다. 보내지 않거나 null, 빈 문자열이면 그대로 둡니다.

Maximum string length: 32
예시:

"+82 10 2938 4756"

firstSeenAt
string<date-time>

연락처가 처음 본 날로 표시되는 날짜(예: 그 사람이 서비스에 가입한 날). 오프셋이 있는 RFC 3339 또는 Z, 미래가 아니어야 하며 2000-01-01 이후. 새 연락처와 이미 있는 연락처 모두에서 저장된 날짜를 바꿉니다. 보내지 않으면 그대로 둡니다(새 연락처는 이 호출의 시각이 됩니다).

예시:

"2025-12-24T01:02:03Z"

tags
string[]

이미 가지고 있는 태그 이름, 최대 10개. 없는 이름이 있으면 422 TAG_NOT_FOUND이고 아무것도 쓰지 않습니다.

Maximum array length: 10
예시:

직접 받은 마케팅 수신 동의. 동의를 주지 않으려면 생략하세요.

응답

연락처가 이미 있었고, 보낸 내용으로 갱신되었습니다(created: false).

id
string<uuid>
필수

연락처의 id.

email
string
필수

저장된 주소(공백 제거, 소문자).

created
boolean
필수

이 호출이 연락처를 만들었으면 true, 이미 있었으면 false.

연락처가 지금 가진 마케팅 수신 동의. marketing: true를 보냈는데 false라면 적용되지 않은 것입니다(수신 거부했거나 주소가 차단됨).

tags
string[]
필수

이 호출이 붙인 태그의 저장된 이름. 모두 지금 연락처에 붙어 있습니다.