The Clapvo API lets you send WhatsApp messages from your connected numbers directly from your own systems — no agent or dashboard needed. This reference covers everything you need to make your first request.
Base URL
All API requests are made to:
Authentication
Every request must include your API token in the x-api-key header. Requests without a valid token are rejected.
You generate tokens from the Developer section in Clapvo. See Authentication for step-by-step instructions on creating and managing your API token.
Keep your API token secret. Treat it like a password — never expose it in client-side code or public repositories.
from and to use international format with the country code and no leading +, spaces, or dashes.
| Number | Format |
|---|
| +91 84956 32548 | 918495632548 |
from number must be a WhatsApp number connected to your Clapvo account. See Add a connection to connect a number.
Message types
A single endpoint, Send a message, handles every message type. Set message.type to choose what you send:
| Type | type value | Notes |
|---|
| Text | message | Put your text in message.message |
| Image | image | Include a media object |
| Document | document | Include a media object |
| Video | video | Include a media object |
| Audio | audio | Include a media object |
caption is optional; all other fields are required.
Ready to dive in? Head to the Send a message endpoint to try it live.
Status codes
Each response returns a standard HTTP status code so you can tell what happened at a glance.
| Code | Status | Description |
|---|
200 | Success | Message queued for delivery |
400 | Bad Request | Invalid or missing required parameters |
401 | Unauthorized | Invalid or expired API token |
403 | Access denied | The token lacks permission for this action |
404 | Connection not found | The from number is not a connection on your account |
