---
title: "브랜드 메시지 와이드 이미지 파일 업로드"
method: POST
path: "/v2/messages/kakao/brand-message/image/upload/wide"
tags: ["Kakao"]
---

# 브랜드 메시지 와이드 이미지 파일 업로드

`POST /v2/messages/kakao/brand-message/image/upload/wide`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/messages/kakao/brand-message/image/upload/wide`
- Auth: HTTP basic

브랜드 메시지 와이드형 템플릿에서 사용할 800x600 이미지 파일을 업로드합니다. JPG, PNG, GIF 형식을 지원하며 최대 2MB까지 업로드할 수 있습니다.

## Request body `multipart/form-data`

- object
  - `file` string, binary: 업로드할 이미지 파일입니다. **지원 형식**: JPG, JPEG, PNG **파일 크기**: 최대 2MB **권장 크기**: - 일반 이미지: 800x400px (2:1 비율) - 와이드 이미지: 800x600px (4:3 비율) - 캐러셀 이미지: 800x800px (1:1 비율) - 아이템리스트 메인: 800x400px (2:1 비율) - 아이템리스트 서브: 150x150px (1:1 비율)

## Response `200`

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

- UploadBrandMessageWideImageResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` UploadBrandMessageWideImageResult, required
    - `image` string, uri, required: 업로드된 와이드 이미지 URL입니다.

## Changes

- **2026-11-03** `71dc377792d9`: 4 breaking, 7 info
  - request body became required
  - the request property `file` became not nullable
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/image` from the response with the `200` status
  - …7 more

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/messages/kakao/brand-message/image/upload/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)