Twilio verify webhook events
Twilio sends 15 verify events, including com.twilio.accountsecurity.verify.verification.pending, com.twilio.accountsecurity.verify.verification.approved and com.twilio.accountsecurity.verify.verification.canceled. 2 have sample payloads.
Twilio has two systems that send you webhooks. Messaging, Voice and other products call a URL you set on a number or resource, with form parameters and no event type field. Event Streams sends JSON CloudEvents with a type. The events list names Event Streams types and Conversations (classic) actions, because a status callback has no event name to list. SendGrid's email events are separate: see SendGrid webhooks.
Every event here can also reach agents as an MCP event through Hookdeck: MCP events →
com.twilio.accountsecurity.verify.verification.pending
documented No payload yet
com.twilio.accountsecurity.verify.verification.pending Verification is started and awaits a code
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.verification.approved
documented from Twilio docs (example)
com.twilio.accountsecurity.verify.verification.approved Verification is approved
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
{
"specversion": "1.0",
"type": "com.twilio.accountsecurity.verify.verification.approved",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/AccountSecurity.VerifyEventStreamEvent/3",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.accountsecurity.verify.verification.approved |
Full schema: 37 fields.
From Twilio docs
-
Content type
application/json
com.twilio.accountsecurity.verify.verification.canceled
documented No payload yet
com.twilio.accountsecurity.verify.verification.canceled Verification is canceled
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.verification.expired
documented No payload yet
com.twilio.accountsecurity.verify.verification.expired A verification expires
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.verification.max-attempts-reached
documented No payload yet
com.twilio.accountsecurity.verify.verification.max-attempts-reached Verification hits its attempt limit
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.message.sent
documented No payload yet
com.twilio.accountsecurity.verify.message.sent Verify message goes out
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.message.delivered
documented from Twilio docs (example)
com.twilio.accountsecurity.verify.message.delivered Verify message is delivered
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
{
"specversion": "1.0",
"type": "com.twilio.accountsecurity.verify.message.delivered",
"source": "AB00000000000000000000000001",
"id": "NO00000000000000000000000001",
"dataschema": "https://events-schemas.twilio.com/AccountSecurity.MessageStatusEvent/2",
"datacontenttype": "2025-10-08T07:17:02.363Z",
"data": { … }
} Key fields
| Field | Type | Example |
|---|---|---|
id | string | NO00000000000000000000000001 |
type | string | com.twilio.accountsecurity.verify.message.delivered |
Full schema: 24 fields.
From Twilio docs
-
Content type
application/json
com.twilio.accountsecurity.verify.message.undelivered
documented No payload yet
com.twilio.accountsecurity.verify.message.undelivered Verify message isn't delivered
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.message.failed
documented No payload yet
com.twilio.accountsecurity.verify.message.failed Verify message fails
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.message.read
documented No payload yet
com.twilio.accountsecurity.verify.message.read Verify message is read
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.attempt-dlr.sent
documented No payload yet
com.twilio.accountsecurity.verify.attempt-dlr.sent Verify attempt is sent (discontinued by Twilio)
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.attempt-dlr.delivered
documented No payload yet
com.twilio.accountsecurity.verify.attempt-dlr.delivered Verify attempt is delivered (discontinued by Twilio)
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.attempt-dlr.undelivered
documented No payload yet
com.twilio.accountsecurity.verify.attempt-dlr.undelivered Verify attempt isn't delivered (discontinued by Twilio)
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.attempt-dlr.failed
documented No payload yet
com.twilio.accountsecurity.verify.attempt-dlr.failed Verify attempt fails (discontinued by Twilio)
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
com.twilio.accountsecurity.verify.attempt-dlr.read
documented No payload yet
com.twilio.accountsecurity.verify.attempt-dlr.read Verify attempt is read (discontinued by Twilio)
Identified by type in each CloudEvent on Event Streams; none on classic callbacks
Resource verify
No payload yet.
Route Twilio events by type.
Event Gateway receives every Twilio delivery and filters and routes it by event type, so each service gets only the events it handles.