API

발신번호 등록

작성일 2026.03.14 | 수정일 2026.03.25

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	must	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"
  }
}

Response

{
  "accountId": "12345678901234",
  "limit": 5,
  "senderIds": [
    {
      "handleKey": "SID_abc123",
      "phoneNumber": "01012345678",
      "status": "PENDING",
      "method": null,
      "expireAt": null,
      "autoExtension": true,
      "necessaryMeasures": [
        "BUSINESS_DOCUMENTS"
      ],
      "consignment": false,
      "approvalDocuments": [
        {
          "approvalId": "APR_abc123",
          "status": "PENDING",
          "reason": null,
          "documentList": {
            "certificateDocument": [
              "DOC_abc123"
            ],
            "employmentCertificate": "DOC_def456"
          },
          "consignmentDocumentList": null,
          "dateCreated": "2024-07-01T12:00:00.000Z",
          "dateUpdated": "2024-07-01T12:00:00.000Z"
        }
      ],
      "unlockDuplicate": null,
      "dateCreated": "2024-07-01T12:00:00.000Z",
      "dateUpdated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "limitationDocuments": [],
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}