---
title: "통합 수신거부 연락처 추가"
method: POST
path: "/v2/contacts/blocklist/unified"
tags: ["Contacts"]
---

# 통합 수신거부 연락처 추가

`POST /v2/contacts/blocklist/unified`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/contacts/blocklist/unified`
- Auth: HTTP basic

특정 전화번호를 통합 수신거부 목록에 추가합니다. 통합관리를 켠 계정은 발신번호·카카오 채널·RCS 브랜드와 무관하게 계정의 모든 발송에서 이 번호가 자동으로 제외됩니다. 통합관리를 끈 계정은 기존 수신거부 목록으로 판정합니다.

## Request body

- CreateBlocklistUnifiedRequestDto
  - `phoneNumber` string, required: 통합 수신거부 목록에 추가할 전화번호입니다. 통합관리를 켠 계정은 발신번호·채널과 무관하게 이 번호로 메시지가 발송되지 않으며, 하이픈(-) 없이 숫자만 입력해주세요.
  - `messageType` 'DIRECT' | 'SMS' | 'KAKAO' | 'RCS': 등록 사유가 된 메시지 유형입니다. 기본값 DIRECT는 발신정보 없이 직접 등록한 것을 뜻하며, 어떤 값이든 차단은 계정 단위로 적용됩니다.
  - `senderNumber` string: 등록 사유가 된 발신번호입니다. messageType이 SMS일 때 기록용으로 남으며 차단 범위에는 영향이 없습니다.
  - `kakaoChannelId` string: 등록 사유가 된 카카오 채널 이름입니다. messageType이 KAKAO일 때 기록용으로 남습니다.
  - `rcsBrandId` string: 등록 사유가 된 RCS 브랜드ID입니다. messageType이 RCS일 때 기록용으로 남습니다.
  - `rcsChatbotId` string: 등록 사유가 된 RCS 챗봇ID입니다. messageType이 RCS일 때 기록용으로 남습니다.

## Response `200`

통합 수신거부 연락처 추가가 성공적으로 완료되었습니다. 생성된 통합 수신거부 항목의 ID가 반환됩니다.

- CreateBlocklistUnifiedResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` CreateBlocklistUnifiedResponse, required
    - `id` number, required: 추가된 통합 수신거부 항목의 고유 ID입니다. 해제 시 이 값을 사용합니다.

## Changes

- **2026-11-03** `71dc377792d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/contacts/blocklist/unified/post.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)