Developer API Docs — HK Reach WhatsApp API

Quick Start

Send Your First Message in 3 Steps

Get Your Credentials

After creating your HK Reach account, find your App Name and API Key in your Profile settings.

Add Headers to Requests

Pass X-App-Name and X-Api-Key headers with every request. No OAuth complexity.

Call the API

POST to the external send endpoint with the recipient's number, your template name, and your source application name. That's it!

Authentication

All API requests require two headers:

Header	Description	Example
`X-App-Name`	Your unique application name (case-sensitive)	`myshop-india`
`X-Api-Key`	Your secret API key from the Profile page	`hk_live_ab12cd...`

API Endpoints

POST /api/external/send/template

Send a WhatsApp template message to a single recipient from your third-party application.

curl -X POST https://api.hkreach.in/api/external/send/template \
  -H "X-App-Name: your-app-name" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "917096136319",
    "templateName": "order_confirmation",
    "thirdPartyAppName": "my_billing_software",
    "languageCode": "en",
    "bodyParams": ["John Doe", "ORD-12345", "2,499"]
  }'

              var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-App-Name", "your-app-name");
client.DefaultRequestHeaders.Add("X-Api-Key", "your-api-key");
var result = await client.PostAsJsonAsync(
  "https://api.hkreach.in/api/external/send/template",
  new { 
    to = "917096136319", 
    templateName = "order_confirmation", 
    thirdPartyAppName = "my_billing_software",
    languageCode = "en", 
    bodyParams = new[] { "John", "ORD-12345" } 
  });
            

              import requests
r = requests.post("https://api.hkreach.in/api/external/send/template",
  headers={"X-App-Name":"your-app","X-Api-Key":"your-key"},
  json={
    "to":"917096136319",
    "templateName":"order_confirmation",
    "thirdPartyAppName":"my_billing_software",
    "languageCode":"en",
    "bodyParams":["John","ORD-12345"]
  })
            
const res = await fetch("https://api.hkreach.in/api/external/send/template", {
  method: "POST",
  headers: { "X-App-Name": "your-app", "X-Api-Key": "your-key", "Content-Type": "application/json" },
  body: JSON.stringify({ 
    to: "917096136319", 
    templateName: "order_confirmation", 
    thirdPartyAppName: "my_billing_software",
    languageCode: "en", 
    bodyParams: ["John", "ORD-12345"] 
  })
});