Skip to main content
POST
/
v1
/
api
/
sms
Send SMS (US)
curl --request POST \
  --url https://api.withallo.com/v1/api/sms \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "+1234567890",
  "to": "+0987654321",
  "message": "Hello, this is a test message"
}
'
{
  "data": {
    "from_number": "+1234567890",
    "sender_id": null,
    "to_number": "+0987654321",
    "type": "OUTBOUND",
    "content": "Hello, this is a test message",
    "start_date": "2024-01-15T10:30:00"
  }
}
This endpoint is for sending SMS from US Allo phone numbers. For sending SMS in France, see Send SMS (France).

Authorizations

​
Authorization
string
header
required

Scope needed: SMS_SEND

Body

application/json

Request body for sending an SMS message (US)

​
from
string
required

Your Allo phone number (must be owned by your account)

Example:

"+1234567890"

​
to
string
required

Recipient phone number (E.164 format, same country as 'from')

Example:

"+0987654321"

​
message
string
required

Message content

Required string length: 1 - 1000
Example:

"Hello, this is a test message"

Response

SMS sent successfully

Standard response wrapper for sent SMS

​
data
object

Sent SMS message details