Send Message

GET {{baseUrl}}/sms/:format?api_key=<>&api_secret=<>&client-ref=<>&from=<>&message-class=<>&network-code=<>&status-report-req=<>&text=<>&to=<>&ttl=<>&type_of_media=<>&vcard=<>

Nexmo makes it simple to send and receive a high volume of SMS anywhere in the world within minutes.

Request Params

KeyDatatypeRequiredDescription
api_keystringYour API Key.
api_secretstringYour API Secret.
client-refstringInclude any reference string for your reference. Useful for your internal reports (40 characters max).
fromstringSender address may be alphanumeric (Ex: from=MyCompany20). Restrictions may apply, depending on the destination.
message-classstringSet to 0 for Flash SMS.
network-codestringForce the recipient network operator MCCMNC, make sure to supply the correct information otherwise the message wont be delivered.
status-report-reqstringSet to 1 if you want to receive a delivery report (DLR) for this request. Make sure to configure your Callback URL in your API Settings
textstringBody of the text message (with a maximum length of 3200 characters), UTF-8 and URL encoded value.
tostringMobile number in international format, and one recipient per request.
ttlstringMessage life span in milliseconds.
type_of_mediastringThis can be omitted for text (default), but is required when sending a Binary (binary), WAP Push (wappush), Unicode message (unicode), vcal (vcal) or vcard (vcard).
vcardstringvcard text body correctly formatted.