SMS Channel - Notifyflow

The SMS channel transmits text messages to mobile devices.

Mock Gateway (Development)

By default, the SMS channel runs in a Mock Simulator mode during local development. When a notification is dispatched with channel: "SMS", the worker logs the message text and records a successful delivery attempt immediately. This prevents unnecessary carrier fees while testing integration flows.

Twilio Gateway (Production)

In production, you can select the Twilio provider to deliver text messages over real carriers.

What the interface looks like

Under Providers in the dashboard, configure the following keys:

Account SID: Set as your provider username.
Auth Token: Configured as the secure API key.
From Number: The Twilio phone number (+1…) authorized to send SMS.

SMS Payload requirements

Recipient Format: The recipient field must contain a valid phone number in international E.164 format (e.g. +15555555555).
Content Limits: Avoid exceeding 160 characters in your message body to prevent carriers from splitting your text into multiple billable segments.

Developer Implementation

To send text messages or OTP passcodes, trigger a notification with channel: "SMS". Recipient addresses must be formatted in E.164 notation.

const response = await fetch("https://notifyflow-api.onrender.com/api/v1/notify", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.NOTIFYFLOW_API_KEY
  },
  body: JSON.stringify({
    channel: "SMS",
    recipient: "+15555555555", // International format
    rawBody: "Your Shopwave login verification code is 482910. Expires in 10 minutes.",
    priority: "HIGH"
  })
});

const data = await response.json();
console.log("Ingested SMS ID:", data.notificationId);