Send an SMS Message with Node.js

Quickly send SMS messages in a Node.js application with the Sinch SMS API.

Set up your Node.js application

First we'll create a Node project using npm. This creates a package.json and the core dependencies necessary to start coding.

To create the project, do the following steps:

1. Create a folder called send-sms-app
2. Navigate into the folder you created and run the following command.
   Copy

   Copied

   npm init

   This command adds the node_modules folder and the package.json file. You will be prompted to provide values for the fields. For this tutorial, you can simply accept the default values and press enter at each stage.

3. Add the fetch package with npm to generate the necessary dependencies.
   Copy

   Copied

   npm install node-fetch

Create your file

// Find your Service Plan ID and API Token at dashboard.sinch.com/sms/api/rest
// Find your Sinch numbers at dashboard.sinch.com/numbers/your-numbers/numbers
const SERVICE_PLAN_ID = 'YOUR_servicePlanId';
const API_TOKEN = 'YOUR_API_token';
const SINCH_NUMBER = 'YOUR_Sinch_virtual_number';
const TO_NUMBER = 'sender_number';

import fetch from 'node-fetch';

async function run() {
  const resp = await fetch(
    'https://us.sms.api.sinch.com/xms/v1/' + SERVICE_PLAN_ID + '/batches',
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Authorization: 'Bearer ' + API_TOKEN
      },
      body: JSON.stringify({
        from: SINCH_NUMBER,
        to: [TO_NUMBER],
        body: 'Programmers are tools for converting caffeine into code. We just got a new shipment of mugs! Check them out: https://tinyurl.com/4a6fxce7!'
      })
    }
  );

  const data = await resp.json();
  console.log(data);
}

run();

Fill in your parameters

1. Assign your values to the following parameters:

   Parameter	Your value
   SERVICE_PLAN_ID	The service plan ID found on your Sinch Customer Dashboard. SMS > APIs > REST configuration
   API_TOKEN	The API token found on your Sinch Customer dashboard. SMS > APIs > REST configuration > Click Show to reveal your API token.
   SINCH_NUMBER	Any number you've assigned to your Sinch account. Find the number on your Sinch Customer Dashboard by clicking the service plan ID link and scrolling to the bottom of the page.
   TO_NUMBER	The phone number to which you want to send the test SMS message.

   Double check that the region is correct on your base URL. Learn more about regional options here.

2. Then, save the file.

Send your first SMS message

Now you can execute the code and send your test SMS message.

Run the following command:

node index.mjs

Next steps

• Learn how to recieve SMS

Additional resources

• Visit our API specification to test more endpoints.