SMS API | Unified Agent APIs

Overview

Send SMS or WhatsApp messages. Default channel is SMS (reliable delivery). WhatsApp requires recipient opt-in: they must have messaged your Business number within 24 hours.

Credits

1 credit per call

Providers

TwilioWhatsApp

SDK Method

client.send_message(...)

Parameters

toRequired

string

Phone number (E.164).

messageRequired

string

Message text.

channel

select (default: auto)

Delivery channel. Auto sends via SMS. WhatsApp requires opt-in: recipient must have messaged your Business number in the last 24 hours, otherwise the message is silently dropped by Meta.

Auto (SMS)

SMS

WhatsApp (requires opt-in)

Example Response

{
  "success": true,
  "data": {
    "message_id": "a361d2e2-3da4-4f5e-8a26-300e13cff0bf",
    "channel": "sms",
    "to": "+1234567890",
    "from": "+15551234567",
    "status": "sent"
  },
  "metadata": {
    "provider_used": "twilio",
    "providers_tried": [
      "twilio"
    ],
    "mode_used": null,
    "response_time_ms": 350,
    "request_id": "req_yza567"
  },
  "credits_used": 1
}

Get Started

Create a Suprsonic API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try SMS

Test SMS in the interactive playground. No setup required.

Open Playground