The Twilio integration allows you to send SMS authentication notifications using your own Twilio account instead of SendAuth’s default SMS provider.

Prerequisites

• Active Twilio account
• Twilio phone number capable of sending SMS
• Twilio Account SID and Auth Token

Configuration

Twilio configuration is limited to users with the admin role.

Navigate to Settings → Twilio

Required Fields

Enable Twilio Integration

• Check this box to activate Twilio for your organization

Account SID

• Your Twilio Account SID from the Twilio Console
• Format: Starts with AC followed by alphanumeric characters
• Found at: https://console.twilio.com

Auth Token

• Your Twilio Auth Token from the Twilio Console
• Keep this secret secure and never share it

Phone Number

• Your Twilio phone number in E.164 format
• Example: +14155551234
• Must be SMS-capable

SMS Template

You can customize the SMS message template at Settings → Templates → SMS Template.

Available Variables

• {{LINK}} - Authentication link (required)
• {{REQUESTOR}} - Who made the request
• {{MESSAGE}} - Custom message from requestor

Example Template

{{REQUESTOR}} is requesting authentication via SendAuth. {{MESSAGE}}

Authenticate here: {{LINK}}

Message Delivery

When a user with SMS enabled in their messaging preferences receives an authentication request:

1. SendAuth formats the message using your template
2. Message is sent via Twilio to the user’s phone number
3. User clicks the link to authenticate
4. Transaction is updated in real-time

Pricing

• SMS messages are billed directly by Twilio to your account
• SendAuth does not charge additional fees for using custom Twilio
• Review Twilio’s pricing at https://www.twilio.com/sms/pricing

Status Monitoring

The integration status indicator shows:

• Success - Last SMS was delivered successfully
• Error - Recent delivery failure with error details
• Not yet invoked - Integration configured but not yet used

Troubleshooting

SMS not delivering

• Verify Account SID and Auth Token are correct
• Check phone number format (must be E.164: +1234567890)
• Ensure Twilio phone number has SMS capability
• Verify sufficient Twilio account balance
• Check Twilio logs for delivery errors

Invalid credentials error

• Regenerate Auth Token in Twilio Console
• Update credentials in SendAuth settings
• Verify Account SID matches the token

Phone number format errors

• Use E.164 format: +[country code][number]
• Remove spaces, dashes, or parentheses
• Example: +14155551234 (not (415) 555-1234)

Security Best Practices

• Rotate Auth Token regularly
• Use Twilio’s IP allowlist feature if available
• Monitor Twilio logs for unusual activity
• Set up fraud alerts in Twilio Console
• Never commit credentials to version control

Disabling Twilio

To stop using custom Twilio and return to SendAuth’s default SMS:

1. Navigate to Settings → Twilio
2. Uncheck Enable Twilio Integration
3. Click Save

SendAuth will immediately switch back to the default SMS provider for all future messages.