API

수신거부 번호 추가/수정

작성일 2026.03.23 | 수정일 2026.03.23

POST/block/numbers/

수신거부 번호를 추가하거나 기존 번호를 수정합니다.

blockNumberId를 포함하면 해당 번호를 수정하고, 포함하지 않으면 새로 추가합니다.
계정당 기본 500개까지 등록 가능합니다.

Body Params

Name	Type	Description
blockNumberId	String	수신거부 번호 핸들키 (기존 번호 수정 시 입력, 미입력 시 신규 추가)
phoneNumber	String	수신거부할 전화번호
memo	String	메모 (최대 250자)
blockGroupIds	Array	소속시킬 수신거부 그룹 핸들키 목록

Response

Name	Type	Required	Description
blockNumberId	String	*	수신거부 번호 핸들키
accountId	String	*	계정 고유 ID
phoneNumber	String	*	수신거부 전화번호
memo	String	*	메모
blockGroupIds	Array	*	소속 그룹 핸들키 목록
dateCreated	Date	*	등록 일시
dateUpdated	Date	*	수정 일시

Structure

Request

{
  "phoneNumber": "01012345678",
  "memo": "고객 요청에 의한 수신거부",
  "blockGroupIds": [
    "IM01BG2403201400000000abcdefgh"
  ]
}

Response

{
  "blockNumberId": "IM01BN2403201400000000abcdefgh",
  "accountId": "12345678901234",
  "phoneNumber": "01012345678",
  "memo": "고객 요청에 의한 수신거부",
  "blockGroupIds": [
    "IM01BG2403201400000000abcdefgh"
  ],
  "dateCreated": "2024-03-20T14:00:00.000Z",
  "dateUpdated": "2024-03-20T14:00:00.000Z"
}