---
title: "와이드형 브랜드 메시지 템플릿 등록"
method: POST
path: "/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide"
tags: ["Kakao"]
---

# 와이드형 브랜드 메시지 템플릿 등록

`POST /v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/messages/kakao/send-profiles/{sendProfileId}/brand-message-templates/wide`
- Auth: HTTP basic

와이드형 브랜드 메시지 템플릿을 등록합니다. 800x600 이미지와 짧은 문구, 버튼 구성을 저장하여 주요 프로모션을 돋보이게 합니다.

## Path parameters

- `sendProfileId` string, required

## Request body

- WideBrandMessageTemplateBodyDto
  - `templateName` string, required: 템플릿의 이름입니다. 최대 50자로 관리용으로 활용합니다.
  - `content` string, required: 메시지 본문입니다. 최대 76자까지 작성할 수 있습니다. 와이드 이미지가 주요 콘텐츠이므로 매우 간결한 문구 사용 **변수 사용**: #{변수명} 형식 지원
  - `imageUrl` string, uri, required: 권장 크기가 800x190px이고 최대 용량이 500KB인 와이드 이미지 URL입니다.
  - `imageName` string: 접근성을 위한 이미지 대체 텍스트입니다.
  - `imageLink` string, uri: 이미지를 클릭했을 때 이동할 URL입니다.
  - `buttons` BrandMessageButtonDto[]: 와이드형 조건에 따라 최대 2개까지 등록하는 버튼 목록입니다.
    - `name` string, required: 버튼의 이름입니다.
    - `linkType` 'WL' | 'AL' | 'DS' | 'BK' | 'MD' | 'BT' | 'BC' | 'AC', required: 버튼 링크 타입입니다. - WL: 웹링크 - 외부 웹페이지로 이동 - AL: 앱링크 - 모바일 앱으로 이동 (딥링크) - DS: 배송조회 - 택배 배송 조회 페이지로 이동 - BK: 봇키워드 - 봇에게 특정 키워드 전송 - MD: 메시지전달 - 버튼 텍스트와 메시지 본문을 함께 전송 - BT: 봇전환 - 상담봇으로 전환 - BC: 상담톡전환 - 상담사와 1:1 채팅으로 전환 - AC: 채널추가 - 카카오톡 채널 친구 추가
    - `linkM` string: 모바일 환경에서 이동할 URL입니다.
    - `linkP` string: PC 환경에서 이동할 URL입니다.
    - `linkI` string: iOS 앱에서 사용할 스킴 URL입니다.
    - `linkA` string: Android 앱에서 사용할 스킴 URL입니다.
  - `coupon` BrandMessageCouponDto
    - `title` string, required: 쿠폰 제목입니다. 변수 사용 시 고정 변수명 사용: - #{할인금액}원 할인 쿠폰 (#{할인금액} 범위: 1 ~ 99,999,999) - #{할인율}% 할인 쿠폰 (#{할인율} 범위: 1 ~ 100) - 배송비 할인 쿠폰 - #{상품명} 무료 쿠폰 (#{상품명} 최대 7자) - #{상품명} UP 쿠폰 (#{상품명} 최대 7자) 고정 값 사용 시 변수 자리에 숫자 입력 (예: "10% 할인 쿠폰")
    - `description` string: 쿠폰을 설명하는 문장입니다.
    - `linkM` string: 모바일에서 쿠폰 사용 페이지로 이동할 URL입니다.
    - `linkP` string: PC에서 쿠폰 사용 페이지로 이동할 URL입니다.
    - `linkI` string: iOS 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.
    - `linkA` string: Android 앱에서 쿠폰 사용 페이지로 이동할 딥링크입니다.
  - `fallback` BrandMessageFallbackDto
    - `senderNumber` string, required: 발신자 번호입니다.
    - `type` 'SMS' | 'LMS' | 'MMS', required: 대체 발송 타입입니다. - SMS: 단문 메시지 (90바이트) - LMS: 장문 메시지 (2000바이트) - MMS: 멀티미디어 메시지 (이미지 포함)
    - `message` string, nullable, required: 메시지 내용입니다.
    - `title` string, nullable: LMS 또는 MMS로 발송할 때 사용하는 메시지 제목입니다.
    - `images` string[], nullable: MMS로 전송할 때 사용할 이미지 URL 목록입니다.
    - `isAd` boolean: 대체문자를 광고로 발송할지 여부입니다.
    - `groupId` string, nullable: 대체 발송이 요청되었을 때 할당되는 그룹 ID입니다.

## Response `200`

등록 처리 결과입니다. 오류가 발생해도 HTTP 200으로 응답하므로, 실패 여부는 본문의 code와 errorCode를 확인하세요.

- BrandMessageTemplateMutationResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` BrandMessageTemplateMutationData, required
    - `templateId` string, required: 템플릿의 ID입니다.
    - `templateCode` string, required: 템플릿의 코드입니다.

## Changes

- **2026-11-03** `71dc377792d9`: 8 breaking, 13 warning, 7 info
  - request body became required
  - added `#/components/schemas/BrandMessageCouponDto` to the `coupon` request property `allOf` list
  - added `#/components/schemas/BrandMessageFallbackDto` to the `fallback` request property `allOf` list
  - the `coupon` request property type changed from `object` to no type
  - …24 more

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/messages/kakao/send-profiles/:sendProfileId/brand-message-templates/wide/post.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)