Skip to content

Twilio ​

https://shoutrrr.nickfedor.com/services/sms/twilio/

URL Format ​

twilio://accountSID:authToken@fromNumber/toNumber[/toNumber2/...]

URL Fields ​

  • AccountSID - Twilio Account SID (Required)
    URL part: twilio://accountsid:authtoken@fromnumber/tonumbers/
  • AuthToken - Twilio Auth Token (Required)
    URL part: twilio://accountsid:authtoken@fromnumber/tonumbers/
  • FromNumber - Sender phone number or Messaging Service SID (Required)
    URL part: twilio://accountsid:authtoken@fromnumber/tonumbers/
  • ToNumbers - Recipient phone number(s) (Required)
    URL part: twilio://accountsid:authtoken@fromnumber/tonumbers/

Getting Started ​

To use the Twilio SMS service, you need a Twilio account. You can sign up at twilio.com.

Required Credentials ​

  1. Account SID — Found on your Twilio Console Dashboard
  2. Auth Token — Found on your Twilio Console Dashboard
  3. From Number — A Twilio phone number or Messaging Service SID from your account
  4. To Number(s) — One or more recipient phone numbers in E.164 format

Phone Number Format ​

Phone numbers should be in E.164 format (e.g. +15551234567). Common formatting characters such as spaces, dashes, parentheses, and dots are automatically stripped, so +1 (555) 123-4567 and +1.555.123.4567 are also accepted.

Multiple Recipients ​

You can send the same message to multiple recipients by adding additional phone numbers to the URL path:

twilio://ACXX...XX:token@+15551234567/+15559876543/+15551111111/+15552222222

Each recipient receives an independent API call. If delivery fails for one recipient, the remaining recipients are still attempted and all errors are returned together.

Messaging Service SID ​

Instead of a phone number, you can use a Twilio Messaging Service SID as the sender. Messaging Service SIDs start with MG:

twilio://ACXX...XX:token@MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/+15559876543

This is useful when you want Twilio to manage sender selection, opt-out handling, or when sending from a pool of numbers.

Released under the MIT License