---
title: "Send Media"
method: POST
path: "/message/sendMedia/{instance}"
tags: ["Message Controller"]
---

# Send Media

`POST /message/sendMedia/{instance}`

Send media message

## Path parameters

- `instance` string, required

## Request body

- object
  - `number` string, required — Number to receive the message (with country code)
  - `options` object
    - `delay` integer — Presence time in milliseconds before sending message
    - `presence` 'composing' | 'recording' — Presence type to show
  - `mediaMessage` object, required
    - `mediaType` 'image' | 'video' | 'document' | 'audio' — Media type
    - `fileName` string — Name of the file (for media type `document` only)
    - `caption` string — Caption to send with media (except with media type `audio`)
    - `media` string — Media URL or file in base64

## Response `201`

Created

- object
  - `key` object — The key of the message, which identifies the message in the chat.
    - `remoteJid` string — The remote Jid.
    - `fromMe` boolean — Indicates whether the message was sent by the user.
    - `id` string — The ID of the message.
  - `message` object — The message content, which may include various types of messages like text, images, etc.
    - `imageMessage` object — Details of the image message.
      - `url` string — The URL of the image.
      - `mimetype` string — The MIME type of the image.
      - `caption` string — The caption text of the image.
      - `fileSha256` string — The SHA-256 hash of the image file.
      - `fileLength` string — The length of the image file.
      - `height` integer — The height of the image.
      - `width` integer — The width of the image.
      - `mediaKey` string — The media key of the image.
      - `fileEncSha256` string — The SHA-256 hash of the encrypted image file.
      - `directPath` string — The direct path to the image.
      - `mediaKeyTimestamp` string — The timestamp of the media key.
      - `jpegThumbnail` string — The JPEG thumbnail of the image.
      - `contextInfo` object — Additional context information.
  - `messageTimestamp` string — The timestamp of the message, represented as a string.
  - `status` string — The status of the message, such as sent, received, or pending.

---

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