---
title: "Send Media"
method: POST
path: "/streams/whatsapp/send_media"
tags: ["Streams Service"]
---

# Send Media

`POST /streams/whatsapp/send_media`

Send a WhatsApp media message (image, document, audio, video, …) that references a file you have already uploaded with the **Upload file** endpoint. Pass the `media_id` returned by that upload.

Each entry sends one media message; include `message_content` for an optional caption, or `conversation_uuid` to reply into an existing conversation.

**Authentication:** stream token in the `Authorization` header (see **Authentication** in the API Overview).

## Request body

- object
  - `messages` object[], required — The media messages to send.
    - `message_content` string — Optional caption/text sent alongside the media.
    - `conversation_uuid` string — Reply into an existing conversation instead of starting a new one.
    - `media` object, required — The media to attach.
      - `media_id` string, required — ID of a previously uploaded file, from the Upload file endpoint.

## Response `200`

The media message was accepted for delivery.

- object
  - `status` boolean — `true` when the batch was accepted. Individual messages may still carry an `error`.
  - `task_id` string — Identifier for the accepted batch (processed asynchronously).
  - `messages` object[] — One entry per submitted message, in request order.
    - `internal_id` string — The `internal_id` you supplied, echoed back.
    - `message_uuid` string — Platform-assigned unique identifier for the message.
    - `conversation_uuid` string — The conversation this message belongs to.
    - `error` string — Present only when this message failed: the hex error code (e.g. `0x31`). See Error handling in the Overview.
    - `details` string — Human-readable detail for a failed message.

---

[API](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1.md) · [All operations](https://skmtc.net/commpeak/apis/dialer-api-v2-0-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/commpeak/dialer-api-v2-0-1/versions/eacecf960bb6/schema)