WhatsApp Business Cloud API Documentation | Developer Guide

OVERVIEW

WhatsApp Cloud API Summary

The SMSINDIAHUB WhatsApp Business Cloud API provides direct RESTful HTTP access to Meta Cloud API v23.0 infrastructure. Send high-throughput OTP verifications, transactional utility notifications, and dynamic PDF invoices with 99.99% carrier SLA.

Base Endpoint

omni.smsindiahub.in

Response Format

application/json

Authentication

Bearer Token

Delivery Speed

< 3 Seconds SLA

POST API Methods - Authentication OTP

Send Template OTP

POST https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages

Trigger mission-critical authentication codes and login verification passwords directly to customer WhatsApp chats using pre-approved authentication templates with native "Copy Code" autofill buttons.

JSON Payload Parameters

Field Name	Type	Requirement	Description
`messaging_product*`	String	Required	Messaging product type. Always set to `whatsapp`.
`recipient_type*`	String	Required	Always set to `individual`.
`to*`	String	Required	Recipient's mobile phone number with country code without plus (+) prefix (e.g. 919876543210).
`type*`	String	Required	Set to `template`.
`template.name*`	String	Required	Approved template name on Meta portal (e.g. `otp_sms`).
`template.components*`	Array	Required	Array of template elements containing body OTP variables and one-tap button parameters.
`biz_opaque_callback_data`	String	Optional	Custom tracking token returned in real-time delivery status webhooks.

Code Samples & SDKs

curl --location --globoff 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{Token}}' \
  --data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "otp_sms",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "{{1}}"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "123456 is your verification code.For your security, do not share this code."
                    }
                ],
                "sub_type": "url",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}'

import requests

url = "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages"
headers = {
    "Authorization": "Bearer {{Token}}",
    "Content-Type": "application/json"
}
payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "otp_sms",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "{{1}}"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "123456 is your verification code.For your security, do not share this code."
                    }
                ],
                "sub_type": "url",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}

response = requests.post(url, json=payload, headers=headers)
print(response.status_code, response.json())

const axios = require('axios');

async function sendWhatsAppOtp() {
  const url = 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages';
  const token = '{{Token}}';

  const data = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "otp_sms",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "{{1}}"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "123456 is your verification code.For your security, do not share this code."
                    }
                ],
                "sub_type": "url",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
};

  const response = await axios.post(url, data, {
    headers: {
      Authorization: `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  });
  console.log(response.data);
}

sendWhatsAppOtp();

<?php
$curl = curl_init();

$payload = [
  'messaging_product' => 'whatsapp',
  'recipient_type' => 'individual',
  'to' => '{{to}}',
  'type' => 'template',
  'template' => 
  [
    'name' => 'otp_sms',
    'language' => 
    [
      'code' => 'en',
    ],
    'components' => 
    [
      0 => 
      [
        'type' => 'body',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'text',
            'text' => '{{1}}',
          ],
        ],
      ],
      1 => 
      [
        'type' => 'button',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'text',
            'text' => '123456 is your verification code.For your security, do not share this code.',
          ],
        ],
        'sub_type' => 'url',
        'index' => '0',
      ],
    ],
  ],
  'biz_opaque_callback_data' => '{{BizOpaqueCallbackData}}',
];

curl_setopt_array($curl, [
    CURLOPT_URL            => "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {{Token}}",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Responses & Schemas

Status: 200 OK Success Schema

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "{{to}}",
      "wa_id": "{{to}}"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTkxOTg3NjU0MzIxMBUCABEYEjA0MTAzNDU5Qzc5M0JGNkZEQwA="
    }
  ]
}

Status: 400 Bad Request Error Schema

{
  "error": {
    "message": "(#100) Param template['components'] has invalid format",
    "type": "OAuthException",
    "code": 100,
    "fbtrace_id": "A4B7C9D0E1F2"
  }
}

POST API Methods - Transactional Alerts

Send Template Utility

POST https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages

Send critical transactional updates, service expiry notices, recharge reminders, shipment tracking, and order confirmations via Meta-approved Utility templates.

JSON Payload Parameters

Field Name	Type	Requirement	Description
`messaging_product*`	String	Required	Always set to `whatsapp`.
`recipient_type*`	String	Required	Always set to `individual`.
`to*`	String	Required	10-12 digit destination mobile number with country code prefix.
`template.name*`	String	Required	Approved utility template name (e.g. `recharge_reminder`).
`template.components*`	Array	Required	Template parameters mapping dynamic text values into message body.

Code Samples & SDKs

curl --location --globoff 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{Token}}' \
  --data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "recharge_reminder",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Hi,\n\nYour Username - xxxx is expiring on DD-MM_YYYY.\nTo continue using messaging service without interruption, please recharge."
                    }
                ]
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}'

import requests

url = "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages"
headers = {
    "Authorization": "Bearer {{Token}}",
    "Content-Type": "application/json"
}
payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "recharge_reminder",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Hi,\n\nYour Username - xxxx is expiring on DD-MM_YYYY.\nTo continue using messaging service without interruption, please recharge."
                    }
                ]
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}

response = requests.post(url, json=payload, headers=headers)
print(response.status_code, response.json())

const axios = require('axios');

async function sendWhatsAppUtility() {
  const url = 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages';
  const token = '{{Token}}';

  const data = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "recharge_reminder",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Hi,\n\nYour Username - xxxx is expiring on DD-MM_YYYY.\nTo continue using messaging service without interruption, please recharge."
                    }
                ]
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
};

  const response = await axios.post(url, data, {
    headers: {
      Authorization: `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  });
  console.log(response.data);
}

sendWhatsAppUtility();

<?php
$curl = curl_init();

$payload = [
  'messaging_product' => 'whatsapp',
  'recipient_type' => 'individual',
  'to' => '{{to}}',
  'type' => 'template',
  'template' => 
  [
    'name' => 'recharge_reminder',
    'language' => 
    [
      'code' => 'en',
    ],
    'components' => 
    [
      0 => 
      [
        'type' => 'body',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'text',
            'text' => 'Hi,

Your Username - xxxx is expiring on DD-MM_YYYY.
To continue using messaging service without interruption, please recharge.',
          ],
        ],
      ],
    ],
  ],
  'biz_opaque_callback_data' => '{{BizOpaqueCallbackData}}',
];

curl_setopt_array($curl, [
    CURLOPT_URL            => "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {{Token}}",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Responses & Schemas

Status: 200 OK Success Schema

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "{{to}}",
      "wa_id": "{{to}}"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTEwOTg3NjU0MzIxMBUCABEYEjg5MTAzNDU5Qzc5M0JGNkZEQwA="
    }
  ]
}

Status: 400 Bad Request Error Schema

{
  "error": {
    "message": "(#132000) Template name does not exist in the translated language",
    "type": "OAuthException",
    "code": 132000
  }
}

POST API Methods - Media & Documents

Media & PDF Invoices

POST https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages

Dispatch dynamic invoices, brochures, e-tickets, and account statements as high-resolution PDF attachments with interactive quick-reply buttons (e.g. "Download now!").

JSON Payload Parameters

Field Name	Type	Requirement	Description
`template.name*`	String	Required	Media template identifier (e.g. `Invoice_print`).
`header.document.link*`	String	Required	Publicly accessible HTTPS link to PDF document file.
`header.document.filename*`	String	Required	Download filename presented to customer (e.g. `Invoice_INV-2024-001.pdf`).
`button.quick_reply`	Object	Optional	Clickable quick reply button parameters.

Code Samples & SDKs

curl --location --globoff 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {{Token}}' \
  --data '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "Invoice_print",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "document",
                        "document": {
                            "link": "https://omni.smsindiahub.in/invoice/INV-2024-001.pdf",
                            "filename": "Invoice_INV-2024-001.pdf"
                        }
                    }
                ]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Dear ABC,\nKindly refer the invoice for the payment\nThanks\nSMSINDIAHUB"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Download now!"
                    }
                ],
                "sub_type": "quick_reply",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}'

import requests

url = "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages"
headers = {
    "Authorization": "Bearer {{Token}}",
    "Content-Type": "application/json"
}
payload = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "Invoice_print",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "document",
                        "document": {
                            "link": "https://omni.smsindiahub.in/invoice/INV-2024-001.pdf",
                            "filename": "Invoice_INV-2024-001.pdf"
                        }
                    }
                ]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Dear ABC,\nKindly refer the invoice for the payment\nThanks\nSMSINDIAHUB"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Download now!"
                    }
                ],
                "sub_type": "quick_reply",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
}

response = requests.post(url, json=payload, headers=headers)
print(response.status_code, response.json())

const axios = require('axios');

async function sendWhatsAppInvoice() {
  const url = 'https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages';
  const token = '{{Token}}';

  const data = {
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "{{to}}",
    "type": "template",
    "template": {
        "name": "Invoice_print",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "document",
                        "document": {
                            "link": "https://omni.smsindiahub.in/invoice/INV-2024-001.pdf",
                            "filename": "Invoice_INV-2024-001.pdf"
                        }
                    }
                ]
            },
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Dear ABC,\nKindly refer the invoice for the payment\nThanks\nSMSINDIAHUB"
                    }
                ]
            },
            {
                "type": "button",
                "parameters": [
                    {
                        "type": "text",
                        "text": "Download now!"
                    }
                ],
                "sub_type": "quick_reply",
                "index": "0"
            }
        ]
    },
    "biz_opaque_callback_data": "{{BizOpaqueCallbackData}}"
};

  const response = await axios.post(url, data, {
    headers: {
      Authorization: `Bearer ${token}`,
      'Content-Type': 'application/json'
    }
  });
  console.log(response.data);
}

sendWhatsAppInvoice();

<?php
$curl = curl_init();

$payload = [
  'messaging_product' => 'whatsapp',
  'recipient_type' => 'individual',
  'to' => '{{to}}',
  'type' => 'template',
  'template' => 
  [
    'name' => 'Invoice_print',
    'language' => 
    [
      'code' => 'en',
    ],
    'components' => 
    [
      0 => 
      [
        'type' => 'header',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'document',
            'document' => 
            [
              'link' => 'https://omni.smsindiahub.in/invoice/INV-2024-001.pdf',
              'filename' => 'Invoice_INV-2024-001.pdf',
            ],
          ],
        ],
      ],
      1 => 
      [
        'type' => 'body',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'text',
            'text' => 'Dear ABC,
Kindly refer the invoice for the payment
Thanks
SMSINDIAHUB',
          ],
        ],
      ],
      2 => 
      [
        'type' => 'button',
        'parameters' => 
        [
          0 => 
          [
            'type' => 'text',
            'text' => 'Download now!',
          ],
        ],
        'sub_type' => 'quick_reply',
        'index' => '0',
      ],
    ],
  ],
  'biz_opaque_callback_data' => '{{BizOpaqueCallbackData}}',
];

curl_setopt_array($curl, [
    CURLOPT_URL            => "https://omni.smsindiahub.in/v23.0/{{Phone-number-ID}}/messages",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($payload),
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer {{Token}}",
        "Content-Type: application/json"
    ]
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>

Responses & Schemas

Status: 200 OK Success Schema

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "{{to}}",
      "wa_id": "{{to}}"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTEwOTg3NjU0MzIxMBUCABEYEjQ0MTAzNDU5Qzc5M0JGNkZEQwA="
    }
  ]
}

Status: 400 Bad Request Error Schema

{
  "error": {
    "message": "(#100) Failed to fetch media from the provided URL",
    "type": "OAuthException",
    "code": 100
  }
}

DEVELOPER OPERATIONS & GREEN TICK

Technical Support & Onboarding

Need high-volume TPS unlocks, Meta Business Manager verification guidance, WhatsApp green tick badge filing, or dedicated assistance? Our certified Meta CPaaS engineers are available 24/7.

Direct Developer Email

WhatsApp Engineering

Technical assistance with API binds, template approvals, and token security.

support@smsindiahub.in

Green Tick Verification

Meta OBA Specialist

Official Business Account filing and verified green tick advisory.

Request Verification Support →

Transparent Pricing

WhatsApp API Pricing

OTP & Utility from ₹0.18/credit, Marketing ₹1.00/credit plans.

View Pricing Plans →