---
title: "채널 등록"
method: POST
path: "/v2/messages/kakao/send-profiles/register"
tags: ["Kakao"]
---

# 채널 등록

`POST /v2/messages/kakao/send-profiles/register`

인증을 통해 확인된 카카오톡 채널을 등록합니다. 등록 완료 후 알림톡과 친구톡 발송할 수 있습니다.

## Request body

- object — 채널을 등록하기 위한 요청 정보입니다. 알림톡으로 받은 인증 토큰과 카카오톡 채널 정보가 포함됩니다.
  - `id` string — 채널 등록 프로세스 ID입니다. 등록 과정 추적과 상태 관리에 사용됩니다.
  - `token` string, required — 알림톡으로 수신한 6자리 인증 토큰입니다. 정확한 토큰을 입력해야 채널 등록을 할 수 있습니다.
  - `phoneNumber` string, required — 인증 토큰을 수신한 전화번호입니다. 인증 요청 시 사용한 번호와 동일해야 합니다.
  - `channelId` string, required — 센드온 서비스에 등록할 카카오톡 채널 ID입니다. @로 시작하는 카카오톡 채널 ID입니다.
  - `categoryCode` string — 채널의 비즈니스 카테고리를 나타내는 코드입니다. 기본값은 일반 서비스업 코드입니다.

## Response `200`

채널 등록 요청의 처리 결과입니다. 성공 시 등록된 채널의 상세 정보가 포함됩니다.

- object — 채널 등록 요청의 처리 결과입니다. 성공 시 등록된 채널의 상세 정보가 포함됩니다.
  - `code` number — 응답 코드
  - `message` string — 응답 메시지
  - `data` object
    - `id` string — 채널의 고유 ID입니다. 시스템 내부에서 채널을 식별하는 데 사용됩니다.
    - `channelId` string — 카카오톡 채널 ID입니다. @로 시작하는 카카오톡 채널 ID입니다.
    - `channelName` string — 채널의 표시 이름입니다. 사용자에게 메시지 수신 시 표시되는 이름입니다.
    - `status` 'ACTIVE' | 'SUSPENDED' | 'DELETED' — 채널 상태 - ACTIVE: 활성화 상태 - 메시지 발송 가능 - SUSPENDED: 일시 정지 상태 - DELETED: 삭제됨
    - `profileStatus` 'ACTIVATED' | 'DEACTIVATED' | 'BLOCKED' | 'DELETING' | 'DELETED' — 카카오톡 채널 상태 - ACTIVATED: 활성화됨 - DEACTIVATED: 비활성화됨 - BLOCKED: 차단됨 - DELETING: 삭제 진행 중 - DELETED: 삭제됨
    - `dormant` boolean — 채널(발신프로필)의 휴면 상태 여부입니다. true인 경우 일정 기간 사용하지 않아 휴면 상태로 전환되었음을 의미합니다.
    - `block` boolean — 채널(발신프로필)의 차단 상태 여부입니다. true인 경우 정책 위반 등으로 차단된 상태입니다.
    - `updatedBy` string, nullable — 채널(발신프로필)을 마지막으로 수정한 사용자의 ID입니다.
    - `updatedAt` string, date-time, nullable — 채널(발신프로필) 정보가 마지막으로 수정된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `createdAt` string, date-time, nullable — 채널(발신프로필)이 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.

---

[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)