Skip to main content

Twilio (SMS) Integration Setup Guide

Step-by-step guide to setting up your Twilio account for SMS integration and MFA verification codes.

Written by Angel Horowitz
Updated over a week ago

📝 Overview

Twilio powers two key features: SMS messaging for customer and staff notifications, and identity verification for Multi-Factor Authentication (MFA) via Twilio Verify. Both features require a Twilio account and share the same Account SID and Auth Token credentials.

Each organization will need its own Twilio account to use either feature.

⚠️ Important Note: Twilio charges a per-message fee for SMS. Mobile carriers may also apply additional fees for businesses sending messages through 10-digit phone numbers under the A2P 10DLC framework. For more information, visit Twilio's A2P 10DLC Help Page.


🛠️ Setup

1️⃣ Create and Configure Your Twilio Account

Click the arrow to learn how to create and configure your Twilio account

  1. Create a Twilio account on Twilio's website

  2. Log into your Twilio Account and go to the console page at https://www.twilio.com/console

  3. Click on the Show link to display the Auth Token

    Figure 1 - The Twilio Console Page with where to click to show the Auth Token

    User-added image

  4. Take note of both the Account SID and the Auth Token

    Figure 2 - The Twilio Console Page with the Auth Token displayed plus where to click to display Phone Number(s)

    User-added image

  5. Click on the "See all phone numbers link"

  6. Take note of the preferred Phone Number

    Figure 3 - The Active Phone Numbers Page

    User-added image

2️⃣ Enable SMS Integration

Click the arrow to learn how to enable the Twilio integration in Dash

  1. Go to the Integrations & Add-ons page by clicking the Admin drop down menu.

  2. From the Integrations tab you will see the Twilio tile

    Figure 4 - Integrations & Add-0ns - Twilio Integration

  3. Click Get Started within the Twilio tile to access the Enable Toggle.

    Figure 5 - Twilio Integration Settings Dialog

  4. In the settings dialog, enter your Account SID, Auth Token, and Phone Number.

  5. Click Save Settings. The system will verify your credentials with Twilio. If the information is correct, the integration will be enabled. If not, the dialog will remain open for editing.

  6. Send a test SMS to a staff member to confirm the integration is working.

3️⃣ Set Up Twilio Verify (for MFA)

Twilio Verify is used to send verification codes via SMS or voice call as part of the Multi-Factor Authentication (MFA) process. Complete this section if you plan to use MFA.

Click the arrow to learn how to set up Twilio Verify for MFA

⚠️ Related Feature - MFA: The MFA feature must also be configured separately to fully enable identity verification for your users. Learn More

  1. In the Twilio Console, navigate to Verify Console Services. If you don't see Verify in the left sidebar, go to Explore Products and pin it.

    70c14b25-5fd1-4b81-b049-4a7f415aed78.png

  2. Click Create new Service + or Create Service Now in the top right corner.

    8b6bea67-db90-44bb-a2ab-9d4bb92dc921.png
    2b89785c-b526-4840-a264-f28e9bef7b61.png

  3. Enter a Friendly Name for the service. This name will be included in the SMS messages sent to users during verification.

    44c14ee8-e631-4fad-b440-0a03f37d60b9.png

  4. Set the Code Length - the number of characters in the verification code. The default is 6.

  5. Click Save. Your new service will now appear in the Services list.

  6. Locate and copy the Verification SID - you will need this when configuring MFA settings.

    6c790b72-b010-4a9a-aa3e-7c6575aea2aa.png

⚠️ Important Note: Verification codes expire after 10 minutes. This is set by Twilio and cannot be configured.


📊 Reporting

✍️ Note: Twilio billing and usage is managed directly in your Twilio account at twilio.com. This information is not accessible from within the platform.

Did this answer your question?