Send your first SMS with Vobiz

This guide sends one SMS and shows you where its delivery status lands. It takes about five minutes if you already have an account.

Get your credentials

Sign in to the Vobiz Console. Your Auth ID (MA_…) and Auth Token are on the dashboard. Send them as the X-Auth-ID and X-Auth-Token headers on every request.

Get a messaging number

List the numbers on your account that can send messages:

cURL

curl "https://api.vobiz.ai/api/v1/sms/numbers" \
  -H "X-Auth-ID: MA_XXXXXXXX" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

Use a number from the numbers array as from. If the list is empty, buy a number or use the console under SMS & RCS → Numbers.

US numbers need a registered 10DLC campaign or toll-free verification before they can send at scale. Each number’s registration.status in the list above tells you where it stands.

Send the message

curl -X POST "https://api.vobiz.ai/api/v1/sms/messages" \
  -H "X-Auth-ID: MA_XXXXXXXX" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+14155550100",
    "to": ["+14155550123"],
    "channel": "sms",
    "text": "Your verification code is 482913",
    "idempotencyKey": "otp-482913-user-77"
  }'

import requests

resp = requests.post(
    "https://api.vobiz.ai/api/v1/sms/messages",
    headers={
        "X-Auth-ID": "MA_XXXXXXXX",
        "X-Auth-Token": "YOUR_AUTH_TOKEN",
    },
    json={
        "from": "+14155550100",
        "to": ["+14155550123"],
        "channel": "sms",
        "text": "Your verification code is 482913",
        "idempotencyKey": "otp-482913-user-77",
    },
)
print(resp.status_code, resp.json())

const resp = await fetch("https://api.vobiz.ai/api/v1/sms/messages", {
  method: "POST",
  headers: {
    "X-Auth-ID": "MA_XXXXXXXX",
    "X-Auth-Token": "YOUR_AUTH_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from: "+14155550100",
    to: ["+14155550123"],
    channel: "sms",
    text: "Your verification code is 482913",
    idempotencyKey: "otp-482913-user-77",
  }),
});
console.log(resp.status, await resp.json());

A 201 returns the message:

Response (201)

{
  "id": "9b2e1c40-8a3d-4f5e-9c1a-7d6b2e8f4a01",
  "accountId": "MA_XXXXXXXX",
  "direction": "out",
  "channel": "sms",
  "from": "+14155550100",
  "to": "+14155550123",
  "text": "Your verification code is 482913",
  "mediaUrls": null,
  "status": "sent",
  "conversationId": "c7d1e9a3-2b4f-4a6c-8d5e-1f3a9b7c2e04",
  "createdAt": "2026-10-12T10:30:00Z",
  "updatedAt": "2026-10-12T10:30:00Z"
}

sent means the network accepted the message. Keep the id.

This call sends a real message and is billed per segment. Use your own numbers while you test.

Track delivery

Poll the message until status becomes delivered or failed:

cURL

curl "https://api.vobiz.ai/api/v1/sms/messages/9b2e1c40-8a3d-4f5e-9c1a-7d6b2e8f4a01" \
  -H "X-Auth-ID: MA_XXXXXXXX" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"

The response adds a statusHistory array with every state the message passed through. For production, subscribe to webhooks instead of polling, so delivery receipts and replies are pushed to your server.

You have sent an SMS and read its delivery status. The reply, if the recipient answers, lands in a conversation with direction: "in".

Next steps

Retry safely

Always send an idempotencyKey. A retry with the same key returns the original message instead of sending again.

Preview the cost

See the segment count and price for a message before you send it.

Send to India

Add your DLT entity, header and template IDs to every message to Indian numbers.

Go rich with RCS

Buttons, branding and SMS fallback from a verified RCS sender.

Getting Started

API Reference

Guides

Send your first SMS with Vobiz

Next steps

Retry safely

Preview the cost

Send to India

Go rich with RCS

​Next steps

Retry safely

Preview the cost

Send to India

Go rich with RCS

Next steps