Nexmo's SMS API allows you to send and receive text messages to users around the globe through simple RESTful APIs.

  • Programmatically send and receive high volume of SMS anywhere in the world.
  • Build apps that scale with the web technologies that you are already using.
  • Send SMS with low latency and high delivery rates.
  • Receive SMS for free using SMS-enabled local numbers in countries around the world.
  • Only pay for what you use, nothing more.


In this document you can learn about:


To use the Nexmo SMS API, you may need to familiarise yourself with:

  • Authentication - Nexmo SMS API is authenticated with your account API Key and Secret.

  • Webhooks - HTTP requests are made to your application web server so that you can act upon them. For example, the SMS API will send the delivery receipts and inbound SMS.

Getting Started

Send an SMS

Before you begin, Sign up for a Nexmo account  .

Using your Nexmo API_KEY and API_SECRET, available from the dashboard getting started page  , you can now send an SMS message:

curl -X "POST" "https://rest.nexmo.com/sms/json" \
  -d "from=Acme Inc" \
  -d "text=A text message sent using the Nexmo SMS API" \
  -d "to=TO_NUMBER" \
  -d "api_key=NEXMO_API_KEY" \
  -d "api_secret=NEXMO_API_SECRET"

Try it

Building Blocks