> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapbip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# send_media

> Send an image, video, audio, voice note, document or sticker.

Send an image, video, audio, voice note, document or sticker.

## Input

| Field | Type | Notes |
| - | - | - |
| `kind` | `image`, `video`, `audio`, `document` or `sticker` | Limits: 5 MB, 16 MB, 16 MB, 100 MB and 100 KB. |
| `url` | string | An https link. Give this or `upload_id`. |
| `upload_id` | string | From [create\_upload](https://docs.zapbip.com/mcp-reference/create-upload.md). Give this or `url`. |
| `caption` | string, optional | Up to 1024 characters. |
| `filename` | string, optional | Up to 240 characters. |
| `voice` | boolean, optional | Sends audio as a voice note. |
| `reply_to` | string, optional | Id of the message to quote. |

## Output

`{ "message_id": string, "delivery": "sent" | "queued" }`. `queued` means the [24-hour window](https://docs.zapbip.com/concepts/24-hour-window.md) is closed.

A sticker must be `image/webp`. The size and type are checked before anything is sent.

## Message kinds

| Kind | Agent to owner | Owner to agent |
| - | - | - |
| `text` | [send\_message](https://docs.zapbip.com/mcp-reference/send-message.md) | text |
| `image` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 5 MB | the image inline when up to 1 MB, otherwise a signed link |
| `video` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 16 MB | signed link |
| `audio` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 16 MB, `voice` for a voice note | signed link |
| `document` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md), up to 100 MB | signed link, file name and MIME type |
| `sticker` | [send\_media](https://docs.zapbip.com/mcp-reference/send-media.md) | signed link |
| `location` | [send\_location](https://docs.zapbip.com/mcp-reference/send-location.md) | latitude, longitude, name and address |
| `contacts` | [send\_contact](https://docs.zapbip.com/mcp-reference/send-contact.md) | the contact cards |
| `reaction` | [react](https://docs.zapbip.com/mcp-reference/react.md) | `message_id` and `emoji`, routed to the agent that sent the reacted message |
| `choice` | [ask](https://docs.zapbip.com/mcp-reference/ask.md), up to 3 options as buttons and 4 to 10 as a list | `option_id`, `title` and optional `description` |
| quote | `reply_to` on every send | `reply_to`, routed to the agent that sent the quoted message |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.