Send an SMS

Sends an SMS — or an MMS, when media is supplied — from one of your account's phone numbers to one or more recipients. The number in fromNumber must be one you have access to; a number you do not is rejected with 403. Recipients are converted to E.164 and de-duplicated before dispatch, and any that cannot be converted are dropped. Sending is billable and cannot be undone; usage is metered against the account that owns the sending number, and the segment count is provisional until the delivery receipt arrives.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Number to send from. It is parsed with the US as the default region, must be a valid phone number, and must be one you have access to.

toNumbers
array of strings
required

One or more destination numbers. Each is converted to E.164, duplicates are removed, and unusable entries are dropped; if none survive the request fails with 400.

toNumbers*
string
required

Body text. May be an empty string for a media-only send, but the key itself must be present.

media
array of strings

Publicly reachable media URLs. Including any makes the send an MMS.

media
string

Id of your own chat message. When it is a valid UUID and the send is accepted, that message is stamped with the outbound message id and a sent time so delivery receipts can be matched to it.

Responses

401

Missing or invalid API key.

500

SMS sending is not configured, or the send failed unexpectedly.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json