WhatsApp Business API for developers: authentication, endpoints and limits
By ChatVerse · Updated
The ChatVerse WhatsApp developer API is a REST API on api.chatverse.io. You authenticate with an API key from Developer Mode as a Bearer token, call it from your server, and use endpoints for templates, campaigns, chats, the AI bot, forms and OTP. Each account can make 120 requests a minute, and the monthly allowance is 10,000 calls on Basic, 50,000 on Premium and 200,000 on Business; Starter has no Developer API.
What the API is
The WhatsApp Business API on ChatVerse is a plain REST API with JSON bodies. Your server calls ChatVerse, and ChatVerse calls Meta’s WhatsApp Business Platform with your business’s own token. You do not host anything or run Meta’s API yourself. The complete reference is in the WhatsApp API docs.
Authentication
Turn on Developer Mode in your WhatsApp Studio, under Account, then Connection, to create an API key. Send it on every request as a Bearer token in the Authorization header (the X-API-Key header also works).
Call the API from your server only. A request that carries a browser Origin header is refused with 403 BROWSER_NOT_ALLOWED, so a key placed in front-end code never works. A missing, invalid or revoked key returns 401. Details are on the authentication docs page.
Main endpoints
- GET /v1/whatsapp/health checks that your key works and shows the connected number.
- GET /v1/whatsapp/templates lists your templates and their approval status; POST /v1/whatsapp/templates/{name}/send sends an approved template to one number.
- POST /v1/whatsapp/campaigns creates a bulk campaign (up to 5,000 recipients, each with its own variable values); campaigns can be sent, paused, resumed and cancelled.
- GET /v1/whatsapp/chats lists recent conversations, GET /v1/whatsapp/chats/{number}/messages returns the history, and POST /v1/whatsapp/chats/{number}/reply sends a text reply.
- GET and PUT /v1/whatsapp/bot read and configure the AI auto-reply bot, with /v1/whatsapp/bot/metrics and /v1/whatsapp/bot/followups.
- POST /v1/whatsapp/otp/send and POST /v1/whatsapp/otp/verify send and check one-time passwords with an approved Authentication template.
- Forms under /v1/whatsapp/forms can be created, published, sent and their responses read.
WhatsApp only allows free-form messages inside the 24-hour window after a customer writes. Outside it you must send an approved template; a reply after the window closes returns 409.
Example: send a template
This is the example from the docs. It sends the approved template order_update with two variables:
curl -X POST 'https://api.chatverse.io/v1/whatsapp/templates/order_update/send' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"to": "919876543210", "body": ["Rohit", "ORD-123"]}'A successful call returns success: true and a data object with the message_id, the number, the template name and its language. Failures return a non-2xx status and a detail object with an error_type; use error_type in your code, not the message text. See the errors page.
Rate limits and monthly call limits
Every account can make 120 requests a minute. Creating templates, creating or sending campaigns, and creating, publishing or bulk-sending forms have an extra limit of 10 a minute. OTP sending allows one code per number every 30 seconds and at most five per ten minutes. Going over returns 429 with RATE_LIMITED; back off and retry. The rate limits page lists them all.
Separately, each plan includes a number of Developer API calls per month:
- Starter (₹299 a month): no Developer API.
- Basic (₹499 a month): 10,000 calls.
- Premium (₹899 a month): 50,000 calls.
- Business (₹1,799 a month): 200,000 calls.
A plan that does not include the API returns 402. Message charges set by Meta are billed to your own WhatsApp Business account, not by ChatVerse. Compare plans on the WhatsApp pricing page.
Building for many clients
If you build for agencies or run many clients, the Agency plan adds a sign-up API, a Partner API and your own API domain. Read the white label WhatsApp API guide and the organization API docs. For Instagram, see the Instagram Developer API guide.
Questions
- How do I authenticate with the ChatVerse WhatsApp API?
- Create an API key by turning on Developer Mode in your WhatsApp Studio, then send it as Authorization: Bearer YOUR_API_KEY on every request, from your server. Browser requests are refused with 403.
- How many API calls do I get each month?
- Basic includes 10,000 calls a month, Premium 50,000 and Business 200,000. The Starter plan has no Developer API.
- What is the request rate limit?
- Each account can make 120 requests a minute, with tighter limits for campaigns, template and form creation and OTP sending. Going over returns HTTP 429 with error_type RATE_LIMITED.
- Can I send any message at any time?
- No. Free-form replies work within 24 hours of the customer’s last message. Outside that window you must send a template that Meta has approved.