---
title: "MMS 이미지 업로드"
method: POST
path: "/v2/messages/sms/image/upload"
tags: ["SMS"]
---

# MMS 이미지 업로드

`POST /v2/messages/sms/image/upload`

MMS 메시지 발송에 사용할 이미지를 업로드합니다. 최대 3개까지 업로드할 수 있으며, 각 이미지는 최대 5MB까지 지원합니다.

## Response `200`

MMS 이미지 업로드가 성공적으로 완료되었습니다. 업로드된 이미지의 ID가 반환됩니다.

- UploadImagesResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` UploadImages, required
    - `images` UploadImage[], required — 업로드된 이미지들의 목록입니다. 각 이미지에 대한 ID, 크기, 파일명 정보가 포함됩니다.
      - `id` string, required — 업로드된 이미지의 ID입니다.
      - `size` number, required — 업로드된 이미지 파일의 크기입니다. 바이트 단위로 표시되며 MMS 전송 제한을 확인할 수 있습니다.
      - `filename` string, required — 업로드된 이미지 파일의 원본 파일명입니다. 사용자가 업로드한 파일의 이름입니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/versions/525dedc81a05/schema)