SMS Providers Integration

The SMS channel delivers messages to your subscribers’ mobile devices through your configured SMS provider integrations.

How SMS delivery works in Novu

Here’s the typical flow for sending an email notification through Novu:

Configuring SMS providers

To add an SMS provider from the Integration Store, you must configure settings and credentials that are specific to that email providers.

Default sender settings

The From field, which is displayed as the sender of the SMS, is a required default setting for any email provider that you connect. You can override this field during trigger if necessary.

Provider authentication

You must provide credentials specific to your email provider, such as:

• API key
• Auth token
• Account SID
• Username
• Password.

Each provider has different requirements.

Override SMS settings

You can override the SMS settings when triggerring a notification by passing the overrides object. The overrides object field supports an sms property and from, to, and content field overrides. This lets you send a message to a different recipient, from a different sender, or with a different content.

import { Novu } from '@novu/api';  
 
const novu = new Novu({
  secretKey: "<NOVU_SECRET_KEY>",
  // Use serverURL for EU region
  // serverURL: "https://eu.api.novu.co",
});
 
await novu.trigger({ 
  workflowId: "workflowId",
  to: {
    subscriberId: "subscriberId",
  },
  overrides: { 
    sms: {
      to: '+123012345678',
      from: 'Novu Team',
      content: 'This SMS message is from overrides',
    },
  },
});

Target a specific provider

By default, Novu uses your primary SMS provider. If you want to bypass this and force a specific, active integration for a trigger, then use the integrationIdentifier.

This is useful if you have multiple active integrations for different purposes. For example, you might have one integration for transactional SMS and one for security SMS. You can find the integrationIdentifier in the Integration Store of the Novu dashboard.

import { Novu } from '@novu/api';  
 
const novu = new Novu({
  secretKey: "<NOVU_SECRET_KEY>",
  // Use serverURL for EU region
  // serverURL: "https://eu.api.novu.co",
});
 
 
await novu.trigger({
  workflowId: "workflowId",
  to: {
    subscriberId: "subscriberId",
  },
  overrides: { 
    sms: { integrationIdentifier: 'infobip-abcdef', },
  },
});

Supported providers

Here are the SMS providers that are currently supported by Novu. Select any provider to see its detailed setup guide.