Tutorial section - SMS

Send SMS with REST using Node.js

Sending SMS with the REST API using the Node.js programming language

The request module can be used to make REST requests using Node.js to send SMS.

REST requirements and resources

REST (REpresentational State Transfer) uses the HTTP protocol (HTTPS) for conveying SMS operations. A REST account can easily be obtained for using the Tyr SMS Gateway. REST uses JSON to carry the parameters that relate to the REST operation that you are performing. The following are required to send SMS with REST:

  • REST API Key
    API key for the REST SMS API of the Melrose Labs Tyr SMS Gateway

Node.js requirements and resources

Node.js is a scripting/programming language and can be used to quickly and easily add SMS support for programmatically sending and receiving SMS messages. Use it for transactional messaging and notifications between your application and mobiles. The following are required to send SMS using Node.js:

  • Node.js
    Node.js is a scripting/programming language


Create the file sendsms.js containing the code below. Replace the [API_KEY] value with the REST API key for your account.

The following example Node.js code makes a REST HTTPS call to the Melrose Labs SMS API endpoint to send the message Hello World #$£ to mobile number 447712345678 from MelroseLabs. The transaction ID for the message is returned by the endpoint after a successful submission.

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.melroselabs.com/sms/message',
  'headers': {
    'x-api-key': '[API_KEY]',
    'Content-Type': 'application/json'
  body: JSON.stringify({"source":"MelroseLabs","destination":"447712345678","message":"Hello World #$£"})
request(options, function (error, response) { 
  if (error) throw new Error(error);

Using in production

Whatever the language or API, you can send SMS and receive SMS between applications and mobiles for a wide range of uses with any of the trusted and reliable CPaaS services from Melrose Labs. Take a look at our Messaging, SMS gateway and Bulk SMS solutions, and sign-up for a Developer account on our Tyr SMS Gateway service to try us out.

We provide a wide range of CPaaS services and infrastructure to organisations, including cloud platforms that enable you to run your own SMS gateway.

Get in contact with us to find out more about CPaaS voice, messaging, video and identity from Melrose Labs.


For testing your application's SMS support when using the SMPP protocol, we recommend starting with the Melrose Labs SMSC Simulator service to simulate SMS message delivery to mobiles (MT SMS) and simulate SMS messages from mobiles (MO SMS). The SMSC Simulator supports SMPP v3.3, v3.4 and v5.

SMSC Simulator

For live testing and delivery to mobiles, use the reliable and dependable Melrose Labs Tyr SMS Gateway for A2P, P2A, bulk, wholesale and business SMS, text marketing and other uses. The Melrose Labs Tyr SMS Gateway supports REST and SMPP APIs.

Tyr SMS Gateway

Alternative APIs and languages

Other APIs covered in our tutorials that can be used for sending and receiving SMS using Node.js include: SMPP

Other languages covered in our tutorials that can be used for sending and receiving SMS with REST include: Python, PHP, Java, C++, C#, Perl, Go, Ruby

Find out more...

Please provide your name.
Please provide a valid company name.
Please type your message.
Please provide a valid email address.