본문으로 건너뛰기

아웃바운드 등록 ​

먼저 컨택할 대상을 Cherpa 아웃바운드 목록에 넣는 쓰기 전용 API예요. 리드 수집 도구나 사내 스크립트에서 모은 대상을 콘솔에 일일이 입력하지 않고 바로 쌓을 수 있어요.

API 키를 Authorization: Bearer 헤더로 전달해 인증하고, 스페이스는 키에서 자동으로 결정돼요. full(전체 접근) 권한 키가 필요해요.

등록만 할 수 있어요. 아웃바운드 목록·상세 조회와 수정은 제공하지 않아요.

인증
bash
curl -X POST https://api.cherpa.me/v1/public/outbounds \
  -H "Authorization: Bearer chp_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "박서준", "company": "루미너스 스튜디오", "channel": "email" }'

아웃바운드 등록 ​

POST/v1/public/outbounds

아웃바운드 목록에 새 건을 만들어요. 상태는 스페이스의 첫 상태(기본 미접촉)로, 담당자는 미배정으로 들어가요. 담당자 배정과 상태 변경은 콘솔 아웃바운드 관리에서 이어서 해요.

파라미터설명
name필수. 고객명 — 컨택할 대상 (최대 255자)
company회사명
email대상 이메일
phone대상 전화번호. 어떤 표기든 E.164(+8210…)로 정규화돼요
channel컨택 경로. 아래 값 중 하나, 생략하면 other
notes제안 내용 (최대 5,000자)

channel에 쓸 수 있는 값이에요.

값의미
phone전화
email이메일
linkedin링크드인
dmDM
event행사
referral소개
other기타 (기본)

중복 확인은 하지 않아요. 같은 대상을 두 번 보내면 두 건이 만들어지니, 재시도할 때는 호출하는 쪽에서 걸러 주세요.

반환 — 등록된 건의 id · name · status · created_at. status는 상태 키예요 (기본 not_started). 상태 코드 201.

상태의미
400name 누락, 허용되지 않은 channel, 길이 초과
401API 키 누락 또는 무효
403full 권한이 아닌 키
429같은 IP에서 1분에 60건 초과

서버에서 호출하세요

이 API는 full 권한 키가 필요해요. 키가 브라우저 번들에 들어가면 누구나 볼 수 있으니, 웹 페이지가 아니라 서버나 스크립트에서 호출하세요. 웹사이트 문의 폼처럼 브라우저에서 바로 보내야 한다면 인바운드 등록과 inquiry 권한 키를 쓰세요.

요청
bash
curl -X POST https://api.cherpa.me/v1/public/outbounds \
  -H "Authorization: Bearer chp_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "박서준",
    "company": "루미너스 스튜디오",
    "email": "seojun.park@luminous.example",
    "phone": "010-2345-6789",
    "channel": "email",
    "notes": "신규 오피스 이전 예정 — 인테리어 패키지 제안 메일 발송 대상"
  }'
응답 · 201
json
{
  "id": "38e99fd0-dabd-4264-9977-1e5b5a5d8dc9",
  "name": "박서준",
  "status": "not_started",
  "created_at": "2026-11-06T09:49:20Z"
}
응답 · 403
json
{
  "code": 7,
  "message": "이 API 키에는 해당 권한이 없어요",
  "detail": "이 API 키에는 해당 권한이 없어요"
}