WA Orbit API v1
OpenAPI spec Get an API key
Developer reference

The WA Orbit REST API

A single REST API to send WhatsApp messages, run broadcasts & campaigns, manage contacts and templates, trigger automation flows, and receive real-time events — everything your CRM, automation platform or app needs.

Base URL
https://app.waorbit.com/api/v1

What you can do

Send messages
Single, bulk broadcasts, campaigns & scheduled sends
Receive messages
Real-time inbound via webhooks
Contacts & leads
Full CRUD, groups & custom attributes
Templates
Create, update & list WhatsApp templates
Automation flows
Enroll a contact into a flow via API
Delivery status
Per-message sent / delivered / read / failed
Devices
List connected numbers & their status
Account & usage
Plan, limits and message credits

Authentication

Every request is authenticated with a workspace API key. Generate one in your dashboard under More → Developers / API. Send it as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Alternatively pass it in an X-Api-Key header. Keys are scoped to a single workspace and only their hash is stored — copy a key when it is created, it can't be shown again. Keys can be revoked any time and stop working immediately.

Webhooks & real-time events

Register a webhook (see the Webhooks endpoints below) and WA Orbit will POST a JSON envelope to your URL whenever a subscribed event fires. When you set a signing secret, each delivery carries an X-WAOrbit-Signature header (HMAC‑SHA256 of the body) so you can verify authenticity.

Available events

message_received
Inbound message received
message_sent
Outbound message sent
message_delivered
Outbound message delivered
message_read
Outbound message read
message_failed
Outbound message failed
broadcast_status_updated
Broadcast status changed
campaign_status_updated
Campaign status changed
campaign_contact_clicked
Recipient clicked a link
campaign_contact_replied
Recipient replied
contact_opt_in
Contact opted in
contact_updated
Contact updated
device_status_updated
Number/device status changed

Rate limits   No hard request limit is enforced today. Outbound sends draw from your plan's message credits.

Loading endpoints…
WA Orbit REST API · v1 · generated from the live OpenAPI specification