API

수신거부 그룹 추가/수정

작성일 2026.03.23 | 수정일 2026.03.23

POST/block/groups/

수신거부 그룹을 추가하거나 기존 그룹을 수정합니다.

blockGroupId를 포함하면 해당 그룹을 수정하고, 포함하지 않으면 새로 추가합니다.
useAll을 true로 설정하면 계정에 등록된 모든 발신번호에 수신거부가 적용됩니다.

Body Params

Name	Type	Description
blockGroupId	String	수신거부 그룹 핸들키 (기존 그룹 수정 시 입력, 미입력 시 신규 추가)
status	String	그룹 상태 (INACTIVE: 비활성, ACTIVE: 활성, 기본값: INACTIVE)
name	String	그룹 이름 (최대 50자)
useAll	Boolean	전체 발신번호 적용 여부 (기본값: false)
senderNumbers	Array	적용할 발신번호 목록 (useAll이 false일 때 사용)

Response

Name	Type	Required	Description
blockGroupId	String	*	수신거부 그룹 핸들키
accountId	String	*	계정 고유 ID
status	String	*	그룹 상태
name	String	*	그룹 이름
useAll	Boolean	*	전체 발신번호 적용 여부
senderNumbers	Array	*	적용 발신번호 목록
dateCreated	Date	*	등록 일시
dateUpdated	Date	*	수정 일시

Structure

Request

{
  "name": "마케팅 수신거부 그룹",
  "status": "ACTIVE",
  "useAll": false,
  "senderNumbers": [
    "029302266",
    "01012345678"
  ]
}

Response

{
  "blockGroupId": "IM01BG2403201400000000abcdefgh",
  "accountId": "12345678901234",
  "status": "ACTIVE",
  "name": "마케팅 수신거부 그룹",
  "useAll": false,
  "senderNumbers": [
    "029302266",
    "01012345678"
  ],
  "dateCreated": "2024-03-20T14:00:00.000Z",
  "dateUpdated": "2024-03-20T14:00:00.000Z"
}