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

# Create sender for project

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

Creates a sender for a project.

## Path parameters

- `projectId` string, required

## Request body

- KakaotalkInputSenderDto
  - `status` 'DRAFT' | 'SUBMIT' — Create as draft or submit. Defaults to submit.
  - `saveDraftOnFailure` boolean — Flag to save template as draft if submission fails. Defaults to false.
  - `plusFriendId` string, required — PlusFriend ID
  - `details` KakaotalkInputSenderDetailsDto, required
    - `adminPhoneNo` string, phone number, required — Admin phone Not required for draft.
    - `name` string, required — Sender name Not required for draft.
    - `logoImage` string, url — Sender logo - Supported mime types: `image/jpeg` or `image/png`. - Maximum file size: 5MB.
    - `topLevelCategoryCode` string, required — Top level category code, must consist of 3 digits (e.g. 001). Not required for draft.
    - `midLevelCategoryCode` string, required — Mid level category code, must consist of 4 digits (e.g. 0001). Not required for draft.
    - `subLevelCategoryCode` string, required — Sub level category code, must consist of 4 digits (e.g. 0001). Not required for draft.

## Response `201`

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
- `412` — PreconditionFailed
- `500` — InternalServerError

---

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