Rate this page:

Twilio Notify

// Description
// Twilio Notify API to send bulk SMS with the same message (body) as one API request
// Upload notifyList.txt as a private Twilio asset
// notifyList.txt format (comma separated numbers w/wo spaces): +15105550100, +15105550101, +15105550102, +15105550103
// Execute Syntax: https://x.x.x.x/<path>?queryParamPasscode=8675309
// (change passcode below, replace this method with a secure auth method in production)
// Make sure under Functions Global Config tab:
// "Add my Twilio Credentials (ACCOUNT_SID) and (AUTH_TOKEN) to ENV" is CHECKED

const fs = require('fs');

// Add node-fetch 2.6.0 as a dependency under Settings, Dependencies
const fetch = require('node-fetch');

// You must define your unique Twilio Notify SID - below
// Notify will make use of a Twilio Messaging Service which you also need to define with a Twilio number(s)
const notifySid = 'IS076575.....';
const passCode = '8675309'; // CHANGE THIS
// Notify Bulk Message Body to Send
const bulkMsgBody = '😸 Hello from Winston 😸';

exports.handler = function (context, event, callback) {
  const params = new URLSearchParams();
  const queryParamPasscode = event.queryParamPasscode;

  let fileName = '/notifyList.txt';
  let file = Runtime.getAssets()[fileName].path;
  let numbers = fs.readFileSync(file, 'utf8').trim();

  // Must pass a URL query parameter of queryParamPasscode with value of passCode to execute
  if (queryParamPasscode != passCode) return callback('invalid operation'); // You can change the error message

  params.append('Body', bulkMsgBody);

  numbers.split(',').forEach((number) => {
      `{ "binding_type": "sms", "address": "${number}" }`

  let headers = {
      'Basic ' +
      new Buffer.from(context.ACCOUNT_SID + ':' + context.AUTH_TOKEN).toString(

  fetch(`${notifySid}/Notifications`, {
    method: 'POST',
    headers: headers,
    body: params,
    .then((res) => res.json())
    .then((json) => {
      return callback(null, { result: 'success' });
    .catch((err) => {
      return callback({ result: 'error' });
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more