Skip to content
All integrations

Twilio SMS setup

Twilio delivers SMS for high and critical severity events. Configuration is server-side only — there's no per-user Twilio key field. Sign up at twilio.com and budget around $0.0079/SMS in the US.

Setup

  1. Create a Twilio account and verify your identity.
  2. Buy a phone number (one-time ~$1/month).
  3. From the Twilio Console, copy your Account SID and Auth Token.
  4. Add these to your API server's .env:
TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+15555555555

Restart the API server for the change to take effect.

Trial accounts can only send to verified numbers

Twilio trial accounts require you to verify each recipient phone number in the Console first. Upgrade to a paid account to remove this restriction.

Verify it works

  1. Open Settings → Notifications. The SMS row should show configured: yes.
  2. Toggle Send SMS alerts on, then go to Settings → Test alerts and fire a high-severity test.
  3. Check your phone within ~30 seconds.

Reference: Twilio SMS docs.