A session is one WhatsApp link under your account. You create and drive it with the external API at https://backend-dev.wabsync.com/api/v1.

Typical flow

  1. POST /sessions/create with session_name
  2. GET /sessions/{sessionId}/get-qr-code while status is pairing-related
  3. Poll GET /sessions/{sessionId} until status is ready
  4. Send messages and receive inbound traffic (see Webhooks)
List sessions: GET /sessions (pagination via page / per_page).

Status values

These are the status values returned on session resources (and in OpenAPI): Operational tip: treat ready as the gate for outbound messaging and for inbound webhook delivery. Until then, keep polling or watch the dashboard.

How status moves while pairing

As the provider connects the phone, status commonly moves through values such as createdscan_qr_codeready (exact path can include other values from the table). Failed starts end in failed.

Session fields (overview)

Full schemas and try-it-out: API reference tab (spec: https://backend-dev.wabsync.com/docs/external-v1-api-docs.json).