/Integrations
v1.2Twilio
Validate Twilio credentials, sender readiness, and trial-account restrictions.
Integration
Twilio
Confirms SMS credentials and sender configuration.
SMS alerts fail quietly on trial accounts—valid credentials that can only message verified numbers—or when the sending number was released without updating your env. PreFlight verifies account credentials server-side, confirms the sender can be used for SMS checks, and stores callback configuration for delivery status probes.
Requirements
- Twilio Account SID
- Twilio Auth Token
- Verified sending phone number or Messaging Service SID
- Optional status callback URL for Phase 2 delivery checks
Trial account limits
Trial accounts can only message verified numbers. Use a production sender and upgraded account before relying on launch SMS alerts.
What PreFlight checks
| Probe | What it proves |
|---|---|
| Credential auth | Account SID and Auth Token authenticate against Twilio. |
| Sender configuration | The phone number or Messaging Service is valid for outbound SMS. |
| Delivery probe | A safe SMS check can be sent when configured (to verified numbers on trial). |
| Callback storage | Status callback configuration is saved for Phase 2 delivery status checks. |
Failure guidance
| Symptom | Fix |
|---|---|
| Invalid credentials | Confirm Account SID and Auth Token from Twilio Console → Account Info. |
| Unverified recipient (trial) | Verify the destination number in Twilio or upgrade to a production account. |
| Invalid sender | Confirm the phone number or Messaging Service SID is active and SMS-enabled. |
| Delivery failed | Check Twilio message logs for carrier errors and confirm callback URL is reachable. |
Dashboard setup
- Open Integrations → Twilio in your PreFlight project.
- Paste Account SID, Auth Token, and your sending number or Messaging Service SID.
- Optionally add a status callback URL for delivery confirmation probes.
- Run Pre-Flight Check using a verified test number on trial accounts.