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://apis.splashifypro.com/api/v1/public/message

Headers

Header	Value
`Authorization`	`Basic YOUR_API_KEY`
`Content-Type`	`application/json`

Request body


{
  "phoneNumber": "9999999999",
  "callbackData": "promo_2026_04",
  "type": "Template",
  "template": {
    "name": "template_name_here",
    "languageCode": "en",
    "headerValues": [
      "media_url_here"
    ],
    "bodyValues": [
      "body_variable_value"
    ]
  }
}

Field	Required	Notes
`template.headerValues`	yes	Single-element array containing the image’s public HTTPS URL. Allowed: JPEG, PNG. Max 5 MB
`template.bodyValues`	yes (when body has variables)	One entry per body variable

The same shape works for video headers — just point headerValues[0] at an MP4 (≤ 16 MB, H.264 + AAC).

Example


curl -X POST https://apis.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`


{
  "result": true,
  "message": "Message created successfully",
  "id": "b90f02bd-1316-49ce-b5d0-f6be14fce2b8"
}

Error — Template category mismatch


{
  "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.