Convexa API

Conversations. Simplified.

Send messages, manage contacts, and receive webhooks with one Convexa Access Token.

Base URL https://api.convexa.co.in/v1

Getting Started

Step 1 — Get your Convexa Access Token
In the Convexa dashboard go to Settings → API Access. Generate or regenerate your token, then copy it. The full token is shown only once.
Step 2 — Add authentication
Send your token in the Authorization header on every request.
```
Authorization: Bearer cvx_live_xxxxxxxxx
```

Step 3 — Test your token

Call GET /me to confirm the token works.

curl --request GET \
  --url https://api.convexa.co.in/v1/me \
  --header "Authorization: Bearer cvx_live_xxxxxxxxx"

Step 4 — Send your first WhatsApp message

curl --request POST \
  --url https://api.convexa.co.in/v1/messages \
  --header "Authorization: Bearer cvx_live_xxxxxxxxx" \
  --header "Content-Type: application/json" \
  --data '{"to":"919876543210","type":"text","text":"Hello from Convexa"}'

Step 5 — Receive webhook events
Register an HTTPS URL with POST /webhooks and verify X-Convexa-Signature on each delivery.

Tip: GET https://api.convexa.co.in/v1/health needs no token and confirms the API is up.