This event is fired whenever a verification status or a verification message status changes.
Event name: verification.update
Subscribe to this event to track the full lifecycle of a verification request in real time from initiation through to success, failure, or expiry.
When is this event triggered
The verification.update event is dispatched each time a verification request or its associated delivery message transitions to a new state. A single verification flow may generate multiple events as it progresses (e.g., pending → verified).
This event covers both:
Verification status changes: the overall outcome of the verification attempt (e.g., the end user entered the correct code).
Verification message status changes: the delivery status of the OTP message sent to the end user (e.g., the message was delivered to the recipient).
How to subscribe
- Go to Applications > Manage > Webhooks.
- Click Add Endpoint and enter your publicly accessible HTTPS URL.
- Select verification.update from the list of available events.
- Save.
Payload structure
TextCall sends a POST request with a Content-Type: application/json header. Below is an annotated example of the payload: