API Endpoints

A reference map of the public, versioned REST API at /api/v1. For authentication details, request/response envelopes, and a full worked example, see the REST API page. For the exact, always-current contract, use the generated OpenAPI reference served inside your install at /developers/docs.

Auth in one line. Every request carries a workspace key (wsk_…) as Authorization: Bearer or X-Api-Key, and is scoped to that one workspace.

Messaging

EndpointDoes
POST /messagesSend a message (text / location) to a number.
GET /messagesList messages.
GET /messages/{id}Read one message and its delivery status.

Broadcasts, Campaigns & Scheduled

EndpointDoes
GET/POST /broadcastsList / create one-off bulk sends.
GET /broadcasts/{id}, /recipients, /stopRead a broadcast, its per-recipient status, or stop it.
GET/POST /campaignsList / create managed campaigns.
GET /campaigns/{id}, /statistics, /stop, DELETERead a campaign, its stats, stop it, or delete it.
POST /scheduledQueue a send for a future time.

CRM & Pipeline

EndpointDoes
GET/POST /contacts, GET/PUT/DELETE /contacts/{id}Manage contact records.
GET/POST /contact-groupsManage segments.
GET/POST /deals, GET/PUT/DELETE /deals/{id}Sales pipeline; advance a stage by updating stage_id.

Flows, Templates & Auto-replies

EndpointDoes
GET /flows, GET /flows/{id}Read chatbot flows.
POST /flows/{id}/enroll, /subscribersEnroll a contact into a flow; list subscribers.
GET/POST /templates (+ per-id)Manage message templates.
GET/POST /auto-replies (+ per-id)Manage keyword / auto-responder rules.

Devices, Account & Webhooks

EndpointDoes
GET /devices, GET /devices/{id}List connected senders and their status.
GET /meRead the current workspace / key context.
Event webhooksReceive inbound & delivery events on your server — see Third-Party Integrations and Webhooks.

Status codes

CodeMeaning
200 / 201Success.
401Missing or expired API key.
403The plan feature for this endpoint is off.
422Validation error — the body names the offending field.
429Rate limit hit (limits are tiered by plan).
WaDesk Documentation