API Documentation

Send WhatsApp messages from your own number with simple HTTP requests. No SDK required — works from browser, cURL, PHP, Python, Node.js, Google Sheets, and more.

Quick start

Create an account and connect your WhatsApp in the dashboard.
Copy your API key from the dashboard.
Send your first message with a GET request:

Successful response:

JSON{ "success": true, "message": "Message sent" }

Authentication

Every API request requires your API key. Pass it in one of two ways:

Method	Example
Query parameter	`?apikey=msg_your_key_here`
HTTP header	`X-API-Key: msg_your_key_here`

Keep your API key secret. Never expose it in public client-side code.

Send text message

The simplest way — a GET request in your browser or any HTTP client.

Parameter	Required	Description
`recipient`	Yes	Phone number with country code, no + (e.g. `598XXXXXX`)
`apikey`	Yes	Your API key
`text`	Yes	Message body

cURL

Send image

Send an image from a public URL. Optional caption via the text parameter.

Parameter	Required	Description
`recipient`	Yes	Phone number with country code
`apikey`	Yes	Your API key
`file`	Yes	Direct public URL to the image (.jpg, .png, etc.)
`text`	No	Caption text

If the image URL contains & or ?, encode it with encodeURIComponent() before adding it to the request. Use direct image links — stock photo sites often block downloads.

Send PDF document

Parameter	Required	Description
`recipient`	Yes	Phone number with country code
`apikey`	Yes	Your API key
`document`	Yes	Direct public URL to a PDF file
`filename`	No	Display name (default: `document.pdf`)

REST API (JSON)

For integrations that prefer POST requests with JSON bodies and header authentication.

POST /api/v1/send — Text

POST /api/v1/send/image — Image

POST /api/v1/send/document — PDF

Check connection status

Verify that your WhatsApp is connected before sending messages.

Response example:

JSON{ "connected": true, "phone": "598XXXXXX", "dailyLimit": 50 }

Errors & limits

HTTP code	Meaning
`400`	Bad request — missing params, WhatsApp not connected, invalid URL
`401`	Invalid or missing API key
`403`	Subscription inactive or expired
`429`	Daily message limit reached

WhatsApp must be connected (QR scanned) in your dashboard before sending. Messages are sent from your own number — use responsibly, no spam.