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

Use this API through the O-mega platform. Create an 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