A Header Template Message is a WhatsApp template that includes a Header at the top of the message. The Header can display text, media, or a location to make the message more informative and engaging.Media Header (Image, Video, Document)
A Media Header Template Message displays a media file in the Header component. It is commonly used to share images, videos, or documents before the message body.| Media Type | Example Usage |
|---|
| Image | Product images, banners |
| Video | Product demos, advertisements |
| Document | Invoices, receipts, brochures |
Note: Only one media type can be used in the Header.
Payload Example#
{
"to": "<USER_PHONE_NUMBER>",
"type": "template",
"template": {
"name": "<TEMPLATE_NAME>",
"language": {
"code": "<LANGUAGE_CODE>"
},
"components": [
{
"type": "header",
"parameters": [
{
"type": "image",
"image": {
"link": "<IMAGE_URL>"
}
}
{
"type": "video",
"video": {
"link": "<VIDEO_URL>"
}
}
{
"type": "document",
"document": {
"link": "<DOCUMENT_URL>"
}
}
]
},
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "<BODY_VARIABLE_VALUE>"
}
]
}
]
}
}
A Location Header Template Message displays a location in the Header component. It is commonly used to share store locations, office addresses, or event venues.Note: A Location Header contains location details instead of media and supports one location per template.
Payload Example#
{
"type": "location",
"location": {
"latitude": "<LATITUDE>",
"longitude": "<LONGITUDE>",
"name": "<LOCATION_NAME>",
"address": "<LOCATION_ADDRESS>"
}
}
Modified at 2026-08-06 06:32:56