---
title: "Register sender for project"
method: POST
path: "/v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/register"
tags: ["KakaoTalk Senders"]
---

# Register sender for project

`POST /v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/register`

## Request

- Base URL: `https://provisioning.api.sinch.com`
- URL: `https://provisioning.api.sinch.com/v1/projects/{projectId}/kakaotalk/senders/{plusFriendId}/register`
- Auth: HTTP basic and HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `https://auth.sinch.com/oauth2/token`

Requests sender registration for a project.

## Path parameters

- `projectId` string, required
- `plusFriendId` string, required

## Response `200`

Sender

- KakaotalkSenderDto
  - `id` string: The unique ID of the sender.
  - `plusFriendId` string, required: PlusFriend ID
  - `state` 'ACTIVE' | 'BLOCKED' | 'INACTIVE' | 'SUSPENDED' | 'VERIFYING': The current state of the sender.
  - `changes` KakaotalkSenderChangesDto
    - `status` 'DRAFT' | 'IN_PROGRESS' | 'REJECTED', required: Current status of the pending changes.
    - `details` union, required: Sender details and information.
      - object
        - `adminPhoneNo` string, required: Admin phone
        - `name` string, required: Sender name
        - `logoImage` string: Sender logo
        - `topLevelCategoryCode` string, required: Top level category code, must consist of 3 digits (e.g. 001).
        - `midLevelCategoryCode` string, required: Mid level category code, must consist of 4 digits (e.g. 0001).
        - `subLevelCategoryCode` string, required: Sub level category code, must consist of 4 digits (e.g. 0001).
      - object
        - `adminPhoneNo` string: Admin phone
        - `name` string: Sender name
        - `logoImage` string: Sender logo
        - `topLevelCategoryCode` string: Top level category code, must consist of 3 digits (e.g. 001).
        - `midLevelCategoryCode` string: Mid level category code, must consist of 4 digits (e.g. 0001).
        - `subLevelCategoryCode` string: Sub level category code, must consist of 4 digits (e.g. 0001).
  - `details` KakaotalkSenderDetailsDto
    - `adminPhoneNo` string, required: Admin phone
    - `name` string, required: Sender name
    - `logoImage` string: Sender logo
    - `topLevelCategoryCode` string, required: Top level category code, must consist of 3 digits (e.g. 001).
    - `midLevelCategoryCode` string, required: Mid level category code, must consist of 4 digits (e.g. 0001).
    - `subLevelCategoryCode` string, required: Sub level category code, must consist of 4 digits (e.g. 0001).
  - `created` string: The UTC Date Time in ISO 8601 for when the sender was created.
  - `modified` string: The UTC Date Time in ISO 8601 for when the sender was last modified.

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `404`: NotFound
- `409`: Conflict
- `500`: InternalServerError

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-09-01** `c6a937922d10`: 7 breaking, 31 info
  - the response's body type changed from no type to `object` for status `400`
  - the response's body type changed from no type to `object` for status `401`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `409`
  - …34 more
- **2026-08-18** `c78a716de420`: 1 info
  - api operation id `SendersController_registerSender_v1` removed and replaced with `KakaotalkSendersController_registerSender_v1`

[Operation history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/kakaotalk/senders/:plusFriendId/register/post.md)

---

[API](https://skmtc.dev/sinch/apis/provisioning-api.md) - [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/provisioning-api/revisions/90d78b3a8575?raw)