Authentication
Include your api_key in every protected request. Get the key after signing in to your account.
API Overview
The HANTAR NOW REST API lets authenticated users send WhatsApp content and connect messaging workflows to external systems.
JSON requests
Use POST with Content-Type: application/json. Some endpoints may accept GET, but POST is recommended.
Server-side only
Keep credentials on your backend. Rotate the API key immediately if it is ever exposed.
Before sending: create an account, activate a subscription, connect a WhatsApp device and copy your API key. Recipient and sender numbers should include their country code without spaces or a plus symbol.
POSThttps://whatsap.tokanity.com/api/id/send-message
Quick cURL example
cURL
curl -X POST 'https://whatsap.tokanity.com/api/id/send-message' \
-H 'Content-Type: application/json' \
-d '{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"message": "Hello from HANTAR NOW"
}'Send Message
Send a text message to a WhatsApp number.
POSThttps://whatsap.tokanity.com/api/id/send-message
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number with country code |
message | string | Yes | Text message to send |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"message": "Hello from HANTAR NOW"
}Send Media
Send an image, video, audio or document using a public media URL.
POSThttps://whatsap.tokanity.com/api/id/send-media
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
media_type | string | Yes | image, video, audio or document |
url | string | Yes | Public HTTPS URL of the media |
caption | string | No | Optional caption |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"media_type": "image",
"url": "https://example.com/image.jpg",
"caption": "Product image"
}Send Sticker
Send a sticker to a WhatsApp number from a public URL.
POSThttps://whatsap.tokanity.com/api/id/send-sticker
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
url | string | Yes | Public sticker URL |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"url": "https://example.com/sticker.webp"
}Send Button
Send an interactive message containing reply buttons.
POSThttps://whatsap.tokanity.com/api/id/send-button
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
message | string | Yes | Message body |
footer | string | No | Optional footer |
button | array | Yes | Button definitions |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"message": "Choose an option",
"footer": "HANTAR NOW",
"button": [
"Yes",
"No"
]
}Send List
Send an interactive list message with selectable rows.
POSThttps://whatsap.tokanity.com/api/id/send-list
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
title | string | Yes | List title |
message | string | Yes | Message body |
buttontext | string | Yes | Button label |
list | array | Yes | List sections and rows |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"title": "Product Menu",
"message": "Select a product",
"buttontext": "View products",
"list": [
{
"title": "Products",
"rows": [
{
"title": "Product A",
"rowId": "product_a"
}
]
}
]
}Send Poll
Send a WhatsApp poll with multiple answer options.
POSThttps://whatsap.tokanity.com/api/id/send-poll
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
name | string | Yes | Poll question |
option | array | Yes | Answer options |
countable | integer | Yes | Maximum selectable answers |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"name": "Choose a delivery time",
"option": [
"Morning",
"Afternoon"
],
"countable": 1
}Send Location
Send geographic coordinates as a WhatsApp location.
POSThttps://whatsap.tokanity.com/api/id/send-location
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
latitude | string | Yes | Location latitude |
longitude | string | Yes | Location longitude |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"latitude": "3.1390",
"longitude": "101.6869"
}Send VCard
Send a contact card to a WhatsApp number.
POSThttps://whatsap.tokanity.com/api/id/send-vcard
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Recipient number |
name | string | Yes | Contact name |
phone | string | Yes | Contact phone number |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432",
"name": "Customer Support",
"phone": "60123456789"
}Check Number
Check whether a phone number is registered on WhatsApp.
POSThttps://whatsap.tokanity.com/api/id/check-number
Request parameters
| PARAMETER | TYPE | REQUIRED | DESCRIPTION |
|---|---|---|---|
api_key | string | Yes | API key from your HANTAR NOW account |
sender | string | Yes | Connected WhatsApp sender/device number |
number | string | Yes | Number to verify |
application/json
{
"api_key": "YOUR_API_KEY",
"sender": "60123456789",
"number": "60198765432"
}Incoming-message Webhooks
Configure a webhook URL on your connected device to receive incoming-message callbacks at your own HTTPS endpoint.
Validate every callback before processing it. Use HTTPS, return a successful 2xx response quickly and move slow work to a queue.
Recommended webhook flow
Receive
Your HTTPS endpoint receives the callback payload.
Validate
Check the sender, expected fields and your own verification rule.
Process
Queue the event, respond 2xx and process business logic safely.