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

# 수신거부 연락처 추가

`POST /v2/contacts/blocklist`

특정 전화번호를 수신거부 목록에 추가합니다. 추가된 연락처는 향후 모든 문자 발송 시 자동으로 제외되어 수신거부 의사를 준수할 수 있습니다. 전화번호와 발신번호 조합으로 관리됩니다.

## Request body

- CreateBlocklistRequestDto
  - `phoneNumber` string, required — 수신거부 목록에 추가할 전화번호입니다. 이 번호로는 향후 메시지가 발송되지 않으며, 하이픈(-) 없이 숫자만 입력해주세요.
  - `messageType` 'SMS' | 'KAKAO' | 'RCS' — 수신거부 할 메시지 타입입니다. SMS, KAKAO, RCS 중 선택할 수 있습니다.
  - `senderNumber` string — 수신거부를 적용할 발신번호입니다. 이 번호로 발송하는 메시지에만 수신거부가 적용되며, 하이픈(-) 없이 숫자만 입력해주세요.
  - `kakaoChannelId` string — 수신거부를 적용할 카카오 채널 이름입니다. 이 채널로 발송하는 메시지에만 수신거부가 적용되며, 채널 이름은 카카오 채널 관리 페이지에서 확인할 수 있습니다.
  - `rcsBrandId` string — 수신거부를 적용할 RCS 브랜드ID입니다. RCS 브랜드 관리 페이지에서 확인할 수 있습니다.
  - `rcsChatbotId` string — 수신거부를 적용할 RCS 챗봇ID입니다. 입력한 RCS 브랜드 ID의 챗봇으로 수신거부가 적용됩니다.

## Response `200`

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

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

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)