Overview

SMS is a scalable channel for reaching users in real-time, even outside your app or website. It boasts some of the highest open and engagement rates of all messaging channels.

SMS channel setup overview

Before sending SMS or MMS messages, make sure you:


SMS setup

In your OneSignal dashboard, navigate to Settings > SMS > Set up SMS.

Activating SMS platform in OneSignal settings

Select provider

You can send SMS using either OneSignal-managed infrastructure or your own Twilio account.

SMS provider selection options


OneSignal leverages Twilio under the hood. Choose this if:

  • You send more than 5,000 SMS per month
  • You are on a paid OneSignal plan (see pricing)

Click Book Demo with SMS Expert to get assistance from our team.

While waiting for verification, you can begin Designing SMS & MMS templates and ensuring you meet the SMS registration requirements.


Set default “From” number

Once verified, OneSignal will retrieve all Twilio phone numbers linked to your account.

Select a default number to use when sending. You can override this later during message creation.

Setting a default phone number

Send a test SMS

Enter your phone number and click Send Test SMS.

If the message doesn’t arrive:

  • Confirm the default number supports SMS
  • Check Twilio logs for errors

Twilio trial accounts require recipient numbers to be pre-registered.

Click Next: Add Subscribers.


Understanding users and subscriptions

Each unique phone number is treated as a separate SMS subscription in OneSignal.

Subscriptions can be created by:

  • Uploading phone numbers via CSV
  • Using the API
  • Capturing numbers with a web prompt
  • Using the SDK’s addSms method

Refer to SMS Opt-in and Collection for implementation details.

Important:

  • Use E.164 format for phone numbers
  • Phone numbers are considered anonymous until you assign them an External ID.

Design SMS & MMS

Great SMS/MMS messages are concise, personalized, and cost-effective. Each message is charged per segment.

Pricing is based on message segments, which depend on character count and encoding type. If your message exceeds segment limits, it may be split and billed as multiple messages.

Use OneSignal’s built-in character estimation to preview segment count and manage cost.

Message personalization and localization

Make your messages more relevant by customizing based on user data and language preferences.

Personalization increases character count and can cause messages to split into multiple segments. Always test before sending to large audiences.


Compliance and registration requirements


Senders

Manage your From phone numbers under Settings > SMS > Senders. Here, you can:

  • Update your default sender
  • Choose whether the number can receive replies

Use built-in and custom keywords for managing user consent:

  • Double opt-in confirmation
  • Opt-out requests (e.g., "STOP")
  • Re-subscription (e.g., "START")
  • Help inquiries

Auto-responders allow you to send automated replies based on keywords.


Analytics and troubleshooting

Monitor performance and troubleshoot delivery:


Congratulations! Your SMS setup is complete.

Next steps:

  • Journeys: Build automated messaging flows
  • Tags: Add user-level data for targeting
  • Analytics: Track engagement and conversion metrics