Send your first WhatsApp message through the API in about five minutes. You need a WaConnect account with at least one connected WhatsApp number.
Create an API key#
In the dashboard, open Settings → Developer settings and click Create API key. Give it a name (for example "My CRM") and copy the key — it starts with wc_live_ and is shown only once.
Check the key works#
GET /v1/me returns your business and credit balance. If you get 401, the key is wrong or was revoked.
curl https://api.waconnect.ai/v1/me \
-H "Authorization: Bearer wc_live_your_key"Connect a WhatsApp number#
Messages are sent from one of your WhatsApp numbers, so it has to be connected first: scan its QR code in Numbers in the dashboard, or from your own app with Connect a number. GET /v1/numbers lists your numbers; a connected one has "status": "CONNECTED".
Send a message#
Set from to your connected WhatsApp number and to to the recipient, both in international format with the country code. With only one connected number, you can leave from out.
curl https://api.waconnect.ai/v1/messages \
-H "Authorization: Bearer wc_live_your_key" \
-H "Content-Type: application/json" \
-d '{"from":"+12125550147","to":"+14155550123","text":"Hello from WaConnect 👋"}'You get 202 Accepted with the message and "status": "PENDING". A moment later it is sent, and it also appears in your WaConnect inbox with an API tag.
Next steps#
- Follow the delivery: Send messages
- Get replies on your server: Receive messages
- Let your users link WhatsApp from your app: Connect a number