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

Overview

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:

Nexmo SMS API Concepts
How to Get Started with the SMS API
SMS API Features
References
Tutorials

Concepts

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
Node.js
Java
C#
PHP
Python
Ruby

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"

var Nexmo = require('nexmo');

var nexmo = new Nexmo({
  apiKey: 'API_KEY',
  apiSecret: 'API_SECRET',
});

var from = 'Nexmo';
var to = 'TO_NUMBER';
var text = 'A text message sent using the Nexmo SMS API';

nexmo.message.sendSms(from, to, text);

NexmoClient client = new NexmoClient(
        new TokenAuthMethod("$API_KEY", "$API_SECRET"));
client.getSmsClient().submitMessage(new TextMessage(
        FROM_NUMBER,
        TO_NUMBER,
        "Hello from Nexmo!"));

SMS.Send(new SMS.SMSRequest
{
    from = "$FROM_NUMBER",
    to = "$TO_NUMBER",
    text = "A text message sent using the Nexmo SMS API"
});

<?php

$credentials = new Nexmo\Client\Credentials\Basic('API_KEY', 'API_SECRET');
$client = new Nexmo\Client($credentials);

$message = $client->message()->send([
  'from' => 'Nexmo',
  'to' => 'NUMBER_TO',
  'text' => 'A text message sent using the Nexmo SMS API'
]);

import nexmo

client = nexmo.Client(key='API_KEY', secret='API_SECRET')

client.send_message({
  'from': 'Nexmo',
  'to': 'TO_NUMBER',
  'text': 'A text message sent using the Nexmo SMS API'
})

require 'nexmo'

client = Nexmo::Client.new({
  key: 'API_KEY',
  secret: 'API_SECRET'
})

client.send_message({
  from: 'Nexmo',
  to: 'TO_NUMBER',
  text: 'A text message sent using the Nexmo SMS API',
})

SMS API Features

References

SMS API Reference

Welcome to Nexmo Developer

Overview

Contents

Concepts

Getting Started

SMS API Features

References

Tutorials