> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifly.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Send a templated Kakao Brand Message

> Send a message using a template.

> [!WARNING]
>
> * The endpoint supports channels that use the `Notifly` KakaoTalk delivery platform. Channels using `Notifly (Legacy)` cannot use this endpoint.
> * A `200` response with `{ "success": true }` confirms only that Notifly queued the request.
> * Contact [contact@notifly.tech](mailto:contact@notifly.tech) for API send statistics. The console does not display those statistics.


## OpenAPI

````yaml /en/api-reference/openapi.yaml post /messages/kakao-brand-message
openapi: 3.0.3
info:
  title: Notifly API
  version: 1.0.0
  contact:
    email: contact@notifly.tech
servers:
  - url: https://api.notifly.tech
    description: Notifly API server
security: []
tags:
  - name: catalog
    x-group: Catalogs
paths:
  /messages/kakao-brand-message:
    post:
      summary: send-kakao-brand-message
      operationId: sendKakaoBrandMessage
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - projectId
                - templateId
                - brandMessageTarget
                - recipientList
              properties:
                projectId:
                  type: string
                  description: Available on the Notifly Settings page.
                templateId:
                  type: string
                  description: ID of the registered message template.
                brandMessageTarget:
                  type: string
                  enum:
                    - M
                    - 'N'
                    - I
                    - I+N
                  description: >-
                    Audience type. Allowed values are `M` for marketing opt-ins,
                    `N` for non-friends, `I` for channel friends, and `I+N` for
                    friends first. With `I+N`, send to `I` first, then retry
                    recipients who failed because they are non-friends as `N`.
                senderGroupingKey:
                  type: string
                  description: Key used to group sends. Up to 100 characters.
                recipientList:
                  type: array
                  items:
                    type: object
                    required:
                      - recipientNo
                    properties:
                      recipientNo:
                        type: string
                        description: Recipient phone number.
                      templateParameter:
                        type: object
                        description: >-
                          Values to substitute into `#{variable}` in the Brand
                          Message template. For example, send `{
                          "customer_name": "홍길동" }` for `#{customer_name}`.
                      failoverTextMessageTemplateParameter:
                        type: object
                        description: >-
                          Variable values for the fallback text template. For
                          example, if the template contains `{{
                          event["coupon_name"] }}`, send `{ "coupon_name": "8월
                          할인 쿠폰" }`. Brand Message fallback texts are sent as
                          promotional SMS. A registered 080 opt-out number is
                          required.
                  description: List of recipients. Up to 1,000 entries.
            example:
              projectId: example_project_1234567890abcdef
              templateId: template-id
              brandMessageTarget: M
              recipientList:
                - recipientNo: '01012345678'
                  templateParameter:
                    customer_name: 홍길동
                  failoverTextMessageTemplateParameter:
                    coupon_name: 8월 할인 쿠폰
      responses:
        '200':
          description: >-
            The send request was queued. This response only confirms queue
            acceptance.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
              example:
                success: true
        '400':
          description: The sender information is not registered.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
              example:
                success: false
                error: Sender info is not registered.
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  error:
                    type: string
              example:
                success: false
                error: Internal Server Error
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Pass the token issued by `POST /authenticate` as a bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.