Twilio Notify allows you to send notification messages to multiple users, over different communication channels, all from the same unified API. With a single API request, you can connect with contacts using SMS, mobile apps, Facebook Messenger, and more. You can even specify preferred channels for reaching certain users, and tag them for more granular sending capabilities.
Below is a simple introduction for getting started with Twilio Notify. For further information, please refer to the full Twilio Notify API documentation.
Notice: Twilio Notify will reach end of life on October 23rd 2023. For full details, including migration options, see Transitioning off Notify.
Notify Service Requirements
Before creating a Twilio Notify service, at least one of the desired communication channels will need to be configured. Please follow the instructions below for enabling messages to each of the desired platforms:
- Text Message: Create a Twilio Programmable SMS Messaging Service
- iOS apps: Configure Apple Push Notification service (APNs)
- Android apps: Configure Firebase Cloud Messaging (FCM, formerly Google Cloud Messaging)
- Facebook Messenger (Preview): Configure Facebook Messenger
- Amazon Alexa (Preview): Request Access to the Alexa Channel
Create a New Twilio Notify Service
New services in Twilio Notify can be created from Console, or the REST API:
- Create a new Twilio Notify service from Console
- Login to your account at www.twilio.com.
- From the left side navigation bar, click Notify .
- Click Services, and then select the + sign icon to create a new Notify service.
- Enter the desired Notify service name in the FRIENDLY NAME field, and then click Create.
- Configure the Notify service as desired, and then click Save.
- Select your credentials from the drop-down menu for each of the desired communication channels.
- Click the Logging settings checkbox to enable or disable logs for each notification request.
- Create a new Twilio Notify service from the REST API
For information on creating, modifying, or deleting a Twilio Notify service via the REST API, please see the full Twilio Notify Services API Resource documentation.
Save Notify Service Contacts with Notify Bindings
Notify contacts can be saved to each Notify service as Identities, with up to 20 different address Bindings across multiple communication channels. For example, an iOS Push notification address binding would be in the form of an APNS device token, while an SMS address binding would be in the form of an E.164 phone number. Creating a Binding for an Identity and Address allows you to send notifications to identities via their preferred contact methods, rather than just to a specific device. Further customization is available in the form of up to 5 Tags per Identity, allowing for greater granularity when sending Notifications.
Identity bindings are managed via the REST API. For further information, please refer to the full Twilio Notify Bindings API Resource documentation.
Send a Notification Message with Twilio Notify
Notify messages are sent via an HTTP POST request to the Notifications Resource. For further information, please refer to the full Twilio Notify Notifications API Resource documentation.