API documentation

We give you an API and you build on it. Examples in cURL, Node.js, PHP and Python. Examples here use placeholders (wc_live_…, conn_…); inside the panel they come with your real data.

OpenAPI specification

The public API (/v1) as a single OpenAPI 3.1 file: import it into Postman/Insomnia, generate a client in your language, or hand it to an AI agent so it can consume the API without reading HTML.

Download openapi.yaml

Getting started

Before writing a line of code it's worth knowing what Meta will ask you for — the part that doesn't depend on us: your own number, a Facebook account with a Business Portfolio, a card on your Meta account and —if you want to write first— an approved template. None of this costs anything here, and you don't need to sign up to read it. Six short steps, in the order things actually happen.

Once you have an account, the panel tells you which of these six you're missing, with your number's real state. Get started.

Essential

Authentication GET /v1/connections
Send a text message POST /v1/messages
Send media (image · document · audio · video) POST /v1/messages
Receive messages by webhook
Authenticate the webhook: static header vs signature
Verify the signature
Check a message's status GET /v1/messages/:id
Download inbound media GET /v1/media/:mediaId

Complete

Send a template POST /v1/messages
Send a template with a file in its header POST /v1/messages
Create, list and sync templates POST /v1/templates
Connections and their health GET /v1/connections
Hosted onboarding (your customer connects their number) POST /v1/onboarding-links
Templates proposed by your customer POST /v1/template-links
Usage and limits GET /v1/usage
The 9 event types with their payload
The full error catalog
Idempotency, retries and delivery order

Something not adding up, or need a custom plan? Write to hola@waiaconnect.com or request a quote.