Skip to main content
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.

​
Phone number format

Both from and to use international format with the country code and no leading +, spaces, or dashes. The 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: For media messages, 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.