Send Template — Image Header
Send an approved template whose header is an image. Common use cases: promotional templates, order confirmations with product photos, banner-style notifications.
The same template can be re-used with a different image URL each send — Meta does not require pre-upload.
Endpoint
POST
https://api.splashifypro.com/api/v1/public/message
Headers
Request body
json
{
"phoneNumber": "9999999999",
"callbackData": "promo_2026_04",
"type": "Template",
"template": {
"name": "template_name_here",
"languageCode": "en",
"headerValues": [
"media_url_here"
],
"bodyValues": [
"body_variable_value"
]
}
}The same shape works for video headers — just point headerValues[0] at an MP4 (≤ 16 MB, H.264 + AAC).
Example
bash
curl -X POST https://api.splashifypro.com/api/v1/public/message \
-H "Authorization: Basic YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "9999999999",
"callbackData": "some text here",
"type": "Template",
"template": {
"name": "template_name_here",
"languageCode": "bg",
"headerValues": ["media_url_here"],
"bodyValues": ["body_variable_value"]
}
}'Successful response — 201 Created
json
{
"result": true,
"message": "Message created successfully",
"id": "b90f02bd-1316-49ce-b5d0-f6be14fce2b8"
}Error — Template category mismatch
json
{
"result": false,
"message": "Message not sent. Template category mismatch: Expected 'utility', but received 'MARKETING'. Please update the request to match the approved template category."
}Image guidelines
- 1.91:1 aspect ratio (landscape banner) renders cleanly on every WhatsApp client. Square works too.
- Avoid copy-heavy images — Meta sometimes rejects images that look like text-only graphics during template approval.
- Keep file size under 1 MB for best load time on slow networks.