Send Freeform Message
Send freeform messages including text, images, documents, audio, and video to recipients within the 24-hour customer service window.
POST/v2.0/whatsapp/message
24-Hour Window Restriction
Freeform messages can only be sent within a 24-hour window after the customer last messaged you. Outside this window, use a template message instead.
Request Parameters
Body Parameters
| Parameter | Type | Description |
|---|---|---|
| to | string | Recipient phone number |
| brandNumber | string | Your WhatsApp Business phone number |
| type | string | Message type: text, image, document, audio, or video |
| content | object | Message content object — structure depends on type |
| scheduledAt | string (ISO 8601) | Schedule for future delivery |
| timezone | string | IANA timezone stringDefault: UTC |
| storeInAIContext | boolean | If true, the outgoing message is appended to the recipient's AI conversation history so subsequent AI replies have context of what you sent. Default falseDefault: false |
Content Object by Type
| Type | Content Fields |
|---|---|
| text | body (required) |
| image | link (required), caption (optional) |
| document | link (required), filename (required), caption (optional) |
| audio | link (required) |
| video | link (required), caption (optional) |
Code Examples
Send Text Message
curl -X POST https://api.sendiee.com/v2.0/whatsapp/message \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "919876543210",
"brandNumber": "917012345678",
"type": "text",
"content": {
"body": "Hello! Thanks for reaching out to us."
}
}'Send Image Message
curl -X POST https://api.sendiee.com/v2.0/whatsapp/message \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "919876543210",
"brandNumber": "917012345678",
"type": "image",
"content": {
"link": "https://example.com/product.jpg",
"caption": "Check out our new product!"
}
}'Response
{
"success": true,
"message": "Message sent successfully",
"data": {
"messageId": "wamid.HBgM...",
"status": "accepted",
"recipient": "919876543210"
}
}Try It
Try it — API Playground