WhatsApp API documentation

One REST call sends a WhatsApp message. One webhook receives every reply.

• Templates to any number — no earlier chat needed
• Text, images, video, audio and documents
• Every number you connected, one API key
• Delivered and read receipts on your webhook
• Opt-outs (STOP) enforced for you
• Test mode that never sends

1. Connect your WhatsApp Business number in IotaBot.
2. Create an API key with messages:send.
3. Send your first template:

curl -X POST "https://api.iotabot.com/v1/messages" \
  -H "Authorization: Bearer $IOTABOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "channel": "whatsapp",
  "to": "+919812345678",
  "template": {
    "name": "order_update",
    "language": "en_US",
    "parameters": [
      "#1042",
      "Friday"
    ]
  }
}' \
  -H "Idempotency-Key: order-1042-shipped"

{
  "data": {
    "id": "6a4ba0f1c3f1a2b3c4d5e733",
    "object": "message",
    "status": "queued",
    "channel": "whatsapp",
    "conversation_id": "6a4b9e21c3f1a2b3c4d5e6f7",
    "created_at": "2026-10-01T09:16:10.004Z"
  }
}