curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-image \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"image": "https://example.com/image.png",
"caption": "Check out this image!",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Messages
Send image
Send image messages via WhatsApp
POST
/
send-image
curl --request POST \
--url https://api.omni.z-api.io/channels/{channel_id}/token/{channel_token}/send-image \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"phone": "5511999999999",
"image": "https://example.com/image.png",
"caption": "Check out this image!",
"viewOnce": false
}
'{
"zaapId": "3999984263738042930CD6ECDE9VDWSA",
"messageId": "D241XXXX732339502B68",
"id": "D241XXXX732339502B68"
}{
"error": 405,
"message": "Method not allowed"
}{
"error": 415,
"message": "Unsupported media type"
}Overview
Method for sending images. You can send the image in two ways: via URL or Base64.When sending as Base64, you must include the prefix with the image type, for example:
data:image/png;base64,. To validate, paste the full Base64 in the browser address bar and verify the image renders correctly.File size limits and supported formats follow WhatsApp policies. See the official WhatsApp documentation for details.
Authorizations
Secret Key generated in the Omni Z-API Security panel
Body
application/json
Recipient phone number (country code + area code + number)
Example:
"5511999999999"
Image URL or Base64 data
Image caption
ID of an existing message to reply to
Delay in seconds before sending (1-15)
Required range:
1 <= x <= 15Send as view-once message