Skip to navigation

WhatsApp Media Message

Send a WhatsApp image message with an optional caption.

Authentication

All requests require an apiKey header containing your Conversive API key.

apiKey: <YOUR_API_KEY>

Pass the API key as a request header named apiKey, not as a Bearer token in the Authorization header.

Request

POST
/api/v2/message/send
curl -X POST https://api.beconversive.com/api/v2/message/send \
-H "apiKey: <apiKey>" \
-H "Content-Type: application/json" \
-d '{
"userPayload": {
"type": "api",
"apiKey": "YOUR_API_KEY"
},
"messageDetails": [
{
"recipient": [
{
"channelType": "whatsapp",
"phone": "8485930"
}
],
"sender": {
"channelType": "whatsapp",
"phone": "48595930"
},
"source": 8001,
"messageId": "wa-media-001",
"message": {
"type": "image",
"content": {
"caption": "Caption with image",
"url": "https://example.com/image.png"
}
}
}
]
}'

Request

userPayloadobjectRequired
messageDetailslist of objectsRequired

Response

Response

responseobjectOptional

Errors

Status CodeMeaning
400Bad Request — missing or invalid parameters
401Unauthorized — invalid or missing API key
403Forbidden — insufficient permissions
404Not Found — endpoint or resource not found
429Too Many Requests — rate limit exceeded
500Internal Server Error — contact support