Workflow node reference
Send Media
Send image, video, document, or audio. Exact configuration, outputs, execution behavior, errors, limits, and examples for the Send Media workflow node.
What this guide covers
- Category: Messages.
- Use it to send an image, video, document, or audio from an upload, URL, variable, or Media library item.
- 12 configuration fields and 3 documented outputs.
- Caption support depends on the selected WhatsApp media type.
What this node does
Send image, video, document, or audio
Use it to send an image, video, document, or audio from an upload, URL, variable, or Media library item.
When not to use it
Do not use it for reusable provider-approved message content or interactive buttons; use Send Template or Send Interactive.
Prerequisites
- Connected Sender
- Eligible recipient
- Reachable or uploaded media
- Supported type and size
- Active customer-service window when required
Connected Sender. Eligible recipient. Reachable or uploaded media. Supported type and size. Active customer-service window when required
Inputs and configuration fields
| Field | Key | Control / type | Requirement | Default | Accepted values and behavior |
|---|---|---|---|---|---|
Media Type | media_type | select | Required when shown | No default | Image (image), Video (video), Document (document), Audio (audio) |
Source | source_type | select | Required when shown | No default | Upload file (upload), From URL (url), From variable (variable), From Files library (library) |
Upload File | file_id | file-upload | Optional | No default | shown when source_type equals upload |
Select from library | file_id | file-library | Optional | No default | shown when source_type equals library |
Media URL | url | variable-input | Optional | No default | shown when source_type equals url. Variables supported |
Variable | variable | variable-input | Optional | No default | shown when source_type equals variable. Variables supported |
Caption | caption | variable-input | Optional | No default | Optional caption.... Variables supported |
Sender & Recipient Override | _divider_override | divider | Optional | No default | Configure which number to send from and who to send to. Value accepted by the displayed control |
Send From Number | send_from | single-number-picker | Optional | No default | Select which WhatsApp number to send from. Required for scheduled/webhook triggers. Optional for message triggers. |
Always use this sender | override_sender | toggle | Optional | false | If enabled, always send from this number even for message triggers. shown when send_from exists |
Send To Number | send_to | variable-input | Optional | No default | Recipient phone number (can use variables). Required for scheduled/webhook triggers. Optional for message triggers.. Variables supported |
Always use this recipient | override_recipient | toggle | Optional | false | If enabled, always send to this number even for message triggers. shown when send_to exists |
Configure the node
- Drag Send Media from Messages in the node palette.
- Select the node to open its configuration drawer.
- Complete every required field and any conditional field revealed by your choices.
- Insert variables only from the current trigger or an earlier node on the same path.
- Connect every required output handle to the intended next step.
- Save and run Workflow Test with representative data before activation.
Outputs
Later nodes can use these values only after this node has run successfully on the same execution path.
| Variable | Type | Meaning |
|---|---|---|
{{nodes.send_media.message_id}} | string | Sent message ID |
{{nodes.send_media.media_url}} | string | Final media URL |
{{nodes.send_media.status}} | string | Delivery status |
Execution behavior
- Selects exactly one source path for the chosen media type.
- Resolves an optional caption and sender/recipient overrides.
- Returns a message ID, final media URL, and accepted status; delivery is asynchronous.
Do not assume a failed node is automatically retried. Review the execution result and the relevant service documentation before repeating an operation that could create a duplicate side effect.
Example use case
Send a PDF invoice URL returned by an earlier Function node.
Message Received → Function → Send Media → Add Note → End FlowCommon errors
| Symptom | Resolution |
|---|---|
Media cannot be loaded | Check file record, URL reachability, content type, and variable value. |
File is too large | Use Media limits: image 5 MB, video 50 MB, document 20 MB, audio 10 MB. |
Recipient is missing | Configure Send To for non-message triggers. |
Limitations
Caption support depends on the selected WhatsApp media type.
Deleting a referenced library item can break the workflow.
Caption support depends on the selected WhatsApp media type. Deleting a referenced library item can break the workflow.