Sign in

v17

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-173538121.5 KB
SMS

Send SMS

Send an SMS message to a phone number. Messages are sent via the Surge SMS API and queued for delivery.

post/v2/send-sms

Request body

from_numberstring

Sender phone number in E.164 format. Optional — defaults to your account's Surge phone number if not provided.

to_numberstring required

Recipient phone number in E.164 format.

messagestring required

The text message to send. Must not be empty.

Example request

{
  "from_number": "+16625658792",
  "to_number": "+17189153182",
  "message": "Hello from OpenMic!"
}

Response

SMS queued for delivery

idstring

Unique message identifier.

from_numberstring

The phone number the message was sent from.

to_numberstring

The phone number the message was sent to.

messagestring

The message body that was sent.

status'queued'

The delivery status of the message.

Example response

{
  "id": "msg_01kpbgtyntfktvzseh0ykcmqm4",
  "from_number": "+16625658792",
  "to_number": "+17189153182",
  "message": "Hello from OpenMic!",
  "status": "queued"
}