Allo

Send SMS

Send an SMS message to a US phone number using one of your Allo phone numbers. The recipient must be in the same country as your Allo number.

POST/v1/api/sms

Authorization

Authorizationstring · headerrequired

Scope needed: SMS_SEND

Body

fromstringrequired

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

tostringrequired

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

messagestringrequired

Message content

Responses

200SMS sent successfully
dataobject

Sent SMS message details

6 fields
from_numberstring | null

Phone number that sent the message. Null when sender_id is used instead.

sender_idstring | null

Sender ID used for the message (alphanumeric identifier). Only populated when sending with a verified Sender ID (e.g., for France SMS). Null when from_number is used.

to_numberstring

Phone number that received the message

typeenum<string>

Direction of the message (always OUTBOUND for sent messages)

OUTBOUND

contentstring

Content of the SMS message

start_datestring<date-time>

When the message was sent

400Bad request
codestring

Error code identifying the type of error

detailsobject[]

Additional error details, or null if not applicable

2 fields
messagestring
fieldstring
401
403
429