Developers

Build on Slovio with one omnichannel messaging API.

Send messages, start calls and manage contacts from your own systems.

An omnichannel messaging API lets developers reach customers on several channels from their own software. The Slovio REST API sends WhatsApp templates and manages contacts over HTTPS, and webhook steps notify your system when a workflow runs. Create an API key in your workspace settings and keep it on your server, never in client code.

Read the docs Create an API key

curl -X POST "$SLOVIO_API_URL/v1/whatsapp/messages" \
  -H "Authorization: Bearer $SLOVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+91XXXXXXXXXX",
    "template": "order_confirmed",
    "variables": {
      "name": "Priya",
      "order": "A-1042"
    }
  }'

curl -X POST "$SLOVIO_API_URL/v1/whatsapp/messages" \
  -H "Authorization: Bearer $SLOVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+91XXXXXXXXXX",
    "template": "order_confirmed",
    "variables": {
      "name": "Priya",
      "order": "A-1042"
    }
  }'

curl -X POST "$SLOVIO_API_URL/v1/sms/messages" \
  -H "Authorization: Bearer $SLOVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+91XXXXXXXXXX",
    "sender_id": "VM-SLOVIO",
    "variables": {
      "otp": "482913"
    },
    "dlt_template_id": "1107XXXXXXXXXXXXXXX"
  }'

curl -X POST "$SLOVIO_API_URL/v1/contacts" \
  -H "Authorization: Bearer $SLOVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Priya S.",
    "email": "priya@example.com",
    "phone": "+91XXXXXXXXXX",
    "attributes": {
      "plan": "trial"
    }
  }'

curl -X POST "$SLOVIO_API_URL/v1/whatsapp/messages" \
  -H "Authorization: Bearer $SLOVIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+91XXXXXXXXXX",
    "template": "order_confirmed",
    "variables": {
      "name": "Priya",
      "order": "A-1042"
    }
  }'

Response

202 Accepted

{
  "id": "msg_8f2c40",
  "channel": "WHATSAPP",
  "status": "QUEUED"
}

Illustrative requests only. Paths and fields are examples; the API reference documents the actual endpoints.

Get started

Your first request in three steps.

Create an API key
Generate a key in your Slovio workspace settings and store it on your server, never in client-side code.
Send a request
Use any language that can make HTTP requests. Start by sending a single message.
Receive events
Add a webhook step to a workflow so your system is notified when something happens.

Webhooks

Receive events with webhooks.

Add a webhook step to a Slovio workflow, and Slovio posts the event to your endpoint as JSON when the workflow runs.

Illustrative event names and payloads.

Build with AI

Describe the task. Your assistant drafts the code.

Give your AI coding assistant the Slovio API reference and describe the task in plain English. Review the requests it drafts before running them. Paths shown are illustrative.

AI coding assistant · API reference in context

Send order_confirmed on WhatsApp to every contact who paid today.

Reading the API reference

Draft requests

GET /v1/contacts?segment=paid-today

POST /v1/whatsapp/messages × 186

Draft ready: fetch the segment, then send the template to each contact. Review it before running.

Frequently asked questions

Does Slovio have an omnichannel messaging API?

Yes. Slovio provides a REST API that your own software can call over HTTPS, authenticated with API keys you create in your Slovio workspace. Developers use it to send messages and manage contacts from their own systems. The Slovio API reference in the documentation lists every available endpoint, request field and response.

How do I send a WhatsApp message through an API?

With Slovio, create an API key in your workspace settings, then send an HTTPS request from your server with the key, the recipient’s number, an approved WhatsApp template and its variables. The Slovio API reference lists the exact endpoint and fields; the request shown on this page is illustrative. Meta must approve a template before it can start a conversation.

How do I get a Slovio API key?

Create one in your Slovio workspace settings, where keys are also revoked, and send it with each API request. Store each key on your server rather than in client-side code or a public repository, and revoke any key you believe has been exposed, then issue a replacement.

Which events can Slovio send by webhook?

Slovio sends webhooks from Automation: add a webhook step to any workflow, and Slovio posts JSON to your endpoint whenever that workflow runs, so any trigger that can start a workflow can notify your system. Webhooks also work the other way, where an incoming HTTP request starts a workflow in Slovio. This lets your systems react to customer activity in Slovio, and lets events from your own applications trigger messages, calls or CRM updates.

Which programming languages work with the Slovio API?

Any language that can make HTTP requests works with the Slovio REST API, including JavaScript, Python, Java, PHP, Go and C#. This page shows illustrative examples in cURL, Node and Python. Slovio does not require an SDK; plain HTTP requests with an API key are all you need to get started.

Can I use an AI coding assistant to build on Slovio?

Yes. You can give an AI coding assistant the Slovio API reference and ask it to draft requests or webhook handlers in plain English. Always review the generated code before running it with your API key, test it on a small set of records first, and keep your key out of any prompt or shared file.

Where is the full list of Slovio API endpoints?

The Slovio API reference in the documentation lists the available endpoints, request fields and responses. The requests, paths and event names shown on this page are illustrative examples only. Always build against the API reference, which is the authoritative source for what the Slovio API currently supports.

Documentation

Learn how it works

All API Reference guides →

API overview and authenticationGet started with the Slovio REST API: the base URL, how to generate API keys, the two authentication headers, the response format and your first request.WebhooksReceive Slovio events (messages, deliveries, contacts, conversations, CSAT, chatbot) on your server — setup, events, payload and delivery retries.Errors and rate limitsSlovio API errors and rate limits explained: the error JSON, validation errors with field paths, authentication errors, HTTP 429 limits and when to retry.

Make your first API request.

Create an API key, send a message and receive your first webhook event.

Read the docs Create an API key

Explore before you choose a plan · Usage billed from a prepaid wallet

Build on Slovio with one omnichannel messaging API.

Your first request in three steps.

Create an API key

Send a request

Receive events

Receive events with webhooks.

Describe the task. Your assistant drafts the code.

Frequently asked questions

Does Slovio have an omnichannel messaging API?

How do I send a WhatsApp message through an API?

How do I get a Slovio API key?

Which events can Slovio send by webhook?

Which programming languages work with the Slovio API?

Can I use an AI coding assistant to build on Slovio?

Where is the full list of Slovio API endpoints?

Learn how it works

Make your first API request.

Build on Slovio with one omnichannel messaging API.

Your first request in three steps.

Create an API key

Send a request

Receive events

Receive events with webhooks.

Describe the task. Your assistant drafts the code.

Frequently asked questions

Does Slovio have an omnichannel messaging API?

How do I send a WhatsApp message through an API?

How do I get a Slovio API key?

Which events can Slovio send by webhook?

Which programming languages work with the Slovio API?

Can I use an AI coding assistant to build on Slovio?

Where is the full list of Slovio API endpoints?

Make your first API request.