Sendveo API

The Sendveo API lets your systems connect WhatsApp numbers, send and receive messages, and stream inbound messages to your own endpoint, all under your Sendveo account. It is a small, predictable REST API that speaks JSON over HTTPS.

Introduction

Every request is authenticated with an API key you create in the dashboard. Responses are JSON, errors share one envelope, and identifiers are opaque strings you can store as-is.

Base URL

All endpoints live under a single versioned base URL:

https://api.sendveo.com/v1

Paths in this reference are relative to that base, for example /numbers is https://api.sendveo.com/v1/numbers.

Quick start

Send your first request. List the numbers on your account:

curl https://api.sendveo.com/v1/numbers \
  -H "X-API-KEY: sv_live_your_key_here"

A successful response:

{
  "numbers": [
    {
      "id": "chn_sales01",
      "displayName": "Sales line",
      "declaredNumber": "+212661234567",
      "pairedNumber": "+212661234567",
      "status": "CONNECTED",
      "connectedAt": "2026-08-19T09:12:00Z"
    }
  ]
}

Live updates in the dashboard

The Sendveo dashboard keeps itself up to date while it is open: delivery ticks move, reactions and edits appear, new messages arrive in the list with their unread counts, and a number changing state shows immediately. It reads a stream at GET /app/events that carries the same sixteen events the webhook carries, in the same shapes. For your own systems the webhook is the channel to use, because it is durable and retriable; the stream is for a browser holding a dashboard session.

Conventions

Phone numbers use E.164 (a leading + and the country code). Timestamps are ISO 8601 in UTC. Identifiers are opaque strings; counts are numbers. All list endpoints return an object with a named array, never a bare array.

Billing is read-only over the API: the billing endpoint answers your slots (by card and by credit, allowed and in use) and the credit available on your account. To buy by card, activate numbers with your credit or read your history of charges and credits, use the Billing page of the dashboard.