Welcome to Nexmo Developer

We are improving our Documentation, API references, learning resources & tooling to help you more effectively use our services. We want to help you find everything you need to integrate Nexmo APIs into your code.

As we start this transition, we’d love to hear from you with thoughts & suggestions. If you’ve got something, positive or negative, to tell us, please tell us using the feedback tool at the bottom of each guide or file an issue on GitHub. - Nexmo


With low latency and high deliverability, our SMS API is the most reliable way to reach users around the globe.

  • 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 and tap into the world's largest inventory of SMS-enabled numbers in real time.
  • Only pay for what you use, nothing more.


In this document you can learn about:


  • Authentication - Nexmo SMS API is authenticated with your account API Key and Secret. For more information on see Authenticating.

  • 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 status of your message and receives inbound SMS.

Getting Started

Send an SMS

SMS Workflow

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 now send an SMS message:

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

SMS API Features