WhatsApp API Documentation
Base URL: https://wazz.clickpak.net
Both /endpoint and /api/endpoint paths are accepted.
Authentication
- Header:
x-api-key: YOUR_KEY - Query string:
?api_key=YOUR_KEY - JSON body field:
api_key
Endpoints
/send-message
— Send Message
Send a WhatsApp text message from a connected sender.
https://wazz.clickpak.net/send-message?api_key=YOUR_API_KEY&sender=62888xxxx&number=62999yyyy&message=Hello%20World
POST https://wazz.clickpak.net/send-message
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "sender": "62888xxxx", "number": "62999yyyy", "message": "Hello World" }
curl -X POST "https://wazz.clickpak.net/send-message" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "sender": "62888xxxx", "number": "62999yyyy", "message": "Hello World" }'
/send-media
— Send Media
Send image / video / audio / document. type = image | video | audio | document. url can be a public URL or a data: URL.
https://wazz.clickpak.net/send-media?api_key=YOUR_API_KEY&sender=62888xxxx&number=62999yyyy&type=image&url=https://example.com/pic.jpg&caption=Hi
POST https://wazz.clickpak.net/send-media
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "sender": "62888xxxx", "number": "62999yyyy", "type": "image", "url": "https://example.com/pic.jpg", "caption": "Hi" }
curl -X POST "https://wazz.clickpak.net/send-media" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "sender": "62888xxxx", "number": "62999yyyy", "type": "image", "url": "https://example.com/pic.jpg", "caption": "Hi" }'
/generate-qr
— Generate QR Code
Create or restart a sender and return a QR code (base64 PNG) to scan in WhatsApp.
https://wazz.clickpak.net/generate-qr?api_key=YOUR_API_KEY&sender=62888xxxx&name=Sales
POST https://wazz.clickpak.net/generate-qr
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "sender": "62888xxxx", "name": "Sales" }
curl -X POST "https://wazz.clickpak.net/generate-qr" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "sender": "62888xxxx", "name": "Sales" }'
/logout-device
— Disconnect Device
Disconnect (logout) a sender from WhatsApp. The sender record is kept.
https://wazz.clickpak.net/logout-device?api_key=YOUR_API_KEY&device_id=1
POST https://wazz.clickpak.net/logout-device
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "device_id": 1 }
curl -X POST "https://wazz.clickpak.net/logout-device" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "device_id": 1 }'
/create-user
— Create User (admin)
Create a new user account. Requires an ADMIN api_key. Returns the new user_id and api_key.
https://wazz.clickpak.net/create-user?api_key=ADMIN_API_KEY&email=client@acme.com&password=secret123&role=user&devices_allowed=2
POST https://wazz.clickpak.net/create-user
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "email": "client@acme.com", "password": "secret123", "role": "user", "devices_allowed": 2 }
curl -X POST "https://wazz.clickpak.net/create-user" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "email": "client@acme.com", "password": "secret123", "role": "user", "devices_allowed": 2 }'
/user-info
— User Info
Return account info for the api_key holder (id, email, level, devices used/allowed, expiry).
https://wazz.clickpak.net/user-info?api_key=YOUR_API_KEY
POST https://wazz.clickpak.net/user-info
Content-Type: application/json
x-api-key: YOUR_API_KEY
{}
curl -X POST "https://wazz.clickpak.net/user-info" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{}'
/info-device
— Device Info
Get sender status (connected, disconnected, scanning) by phone or device id.
https://wazz.clickpak.net/info-device?api_key=YOUR_API_KEY&sender=62888xxxx
POST https://wazz.clickpak.net/info-device
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "sender": "62888xxxx" }
curl -X POST "https://wazz.clickpak.net/info-device" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "sender": "62888xxxx" }'
/create-device
— Create Device
Add a new sender to the account (does not start the WA session). Use Generate QR Code after this to scan.
https://wazz.clickpak.net/create-device?api_key=YOUR_API_KEY&sender=62888xxxx&name=Sales&cms_id=00123&cms_ver=00045
POST https://wazz.clickpak.net/create-device
Content-Type: application/json
x-api-key: YOUR_API_KEY
{ "sender": "62888xxxx", "name": "Sales", "cms_id": "00123", "cms_ver": "00045" }
curl -X POST "https://wazz.clickpak.net/create-device" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{ "sender": "62888xxxx", "name": "Sales", "cms_id": "00123", "cms_ver": "00045" }'
/devices
— List Devices
List all of your senders.
https://wazz.clickpak.net/devices?api_key=YOUR_API_KEY
GET https://wazz.clickpak.net/devices x-api-key: YOUR_API_KEY
curl "https://wazz.clickpak.net/devices?api_key=YOUR_API_KEY"
/messages
— Messages History
Get the last 200 messages history.
https://wazz.clickpak.net/messages?api_key=YOUR_API_KEY
GET https://wazz.clickpak.net/messages x-api-key: YOUR_API_KEY
curl "https://wazz.clickpak.net/messages?api_key=YOUR_API_KEY"
Response shape
All responses are JSON:
{ "ok": true, ... } on success or
{ "ok": false, "error": "..." } on failure.