Send Interactive Media Button Message
POSThttps://public.leadpattern.com/whatsapp/message/interactive-media
Send an interactive button message with an image or video header.
- mediaUrl and mediaType must be supplied together.
- No text header on this endpoint — use interactive-button for that.
Headers
1 fieldAuthorizationstringrequired
Your API key. Sent raw (e.g. 'lp_...'). No Bearer prefix required.
Body Parameters
2 fieldstostringrequired
Recipient phone number in E.164 format (with country code).
contentobjectrequired
bodystringrequired
Body text.
mediaUrlstringoptional
Header media URL (requires mediaType).
mediaTypeenumoptional
Header media type.
Allowed values:
imagevideodocumentfooterstringoptional
Footer text.
buttonsarray of objectsrequired
Reply buttons (max 3).
Responses
JSON Response
{
"type": "success",
"data": {
"messageId": "wamid.abc123",
"status": "sent",
"recipient": "9195XXXXXXXX"
}
}Sample Request Body
{
"to": "+9195XXXXXXXX",
"content": {
"body": "Do you want to book a demo?",
"mediaUrl": "https://example.com/demo-thumb.jpg",
"mediaType": "image",
"buttons": [
{
"id": "book",
"title": "Book Demo"
},
{
"id": "later",
"title": "Maybe Later"
}
]
}
}