API

발신번호 등록

작성일 2026.03.14 | 수정일 2026.03.15

POST/senderid/v1/numbers

권한 추가 조건: 계정 인증 완료, 멤버 상태 ACTIVE

발신번호를 등록합니다. 개인인증 회원은 대기(PENDING) 상태로 생성되며, 사업자인증 회원은 증빙서류(통신서비스이용증명원, 재직증명서) 제출 시 바로 심사가 진행됩니다. 증빙서류 없이 등록하면 필요 조치(necessaryMeasures)가 응답에 포함됩니다.

Body Params

Name	Type	Required	Description
phoneNumber	string	*	등록할 발신번호. 숫자만 8~12자리 (예: '01012345678')
documentList	object		기본 증빙서류. consignmentDocumentList와 동시 사용 불가.
certificateDocument	string[]		통신서비스이용증명원 문서 ID 배열
employmentCertificate	string		재직증명서 문서 ID. 사업자 회원인 경우 기존 인증 시 제출한 재직증명서가 자동으로 사용될 수 있습니다.
consignmentDocumentList	object		위임 증빙서류. documentList와 동시 사용 불가.
employmentCertificate	string		재직증명서 문서 ID
idCard	string		신분증 문서 ID
businessLicense	string		사업자등록증 문서 ID
consignmentAgreement	string[]		위임동의서 문서 ID 배열
powerOfAttorney	string[]		위임장 문서 ID 배열
certificateDocument	string[]		통신서비스이용증명원 문서 ID 배열

Response

Name	Type	Required	Description
accountId	string	*	계정 고유 ID
limit	number	*	발신번호 등록 가능 개수 (기본값: 5)
senderIds	array	*	발신번호 목록 (삭제된 번호 제외)
handleKey	string	*	발신번호 고유 키
phoneNumber	string	*	발신번호
status	string	*	발신번호 상태. PENDING, ACTIVE, INACTIVE, BLOCKED, DUPLICATED, EXPIRED, OVERLIMIT 중 하나
method	string		인증 방법. SELF-CERT, DOCUMENT, ADMIN 중 하나
expireAt	string\|null		만료일시 (ISO 8601). 본인인증 등록 시 6개월 후로 설정됩니다.
autoExtension	boolean		자동 연장 여부 (기본값: true)
necessaryMeasures	string[]\|null		필요한 추가 조치 목록. DUPLICATED, OVERLIMIT, BUSINESS_DOCUMENTS, CONSIGNMENT_DOCUMENTS
consignment	boolean		위임 번호 여부
approvalDocuments	array		증빙서류 심사 내역
unlockDuplicate	object		중복 해제 요청 정보
dateCreated	string	*	등록일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)
limitationDocuments	array	*	개수 제한 해제 요청 내역
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Request

{
  "phoneNumber": "01012345678",
  "documentList": {
    "certificateDocument": [
      "DOC_abc123"
    ],
    "employmentCertificate": "DOC_def456"
  }
}