Verification Event

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:

{
"event": "verification.update",
  "data": {
    "verification_id": "85f56c98-8012-4c63-a654-231a66fef878",
    "recipient": "+35799849997",
    "created_at": "2026-07-15T07:45:48.695Z",
    "updated_at": "2026-07-15T07:45:51.426Z",
    "status": "PENDING",
    "attempts": 0,
    "attempted_channels": [
      {
        "channel": "VIBER",
        "priority": 1,
        "message_id": "449-1754481-7be6-cc1f-651407fa-redeo",
        "sent_at": "2026-07-15T07:45:49.469Z",
        "status_updated_at": "2026-07-15T07:45:50.009Z",
        "parts": 1,
        "price": 0.03,
        "status": "DELIVERED",
        "error_code": null,
        "error_message": null
      }
    ],
    "price": 0.006,
    "currency": "USD",
    "application_id": "c271d7da-3098-4745-81d0-1e2c6d798681",
    "error_code": null,
    "error_message": null
  }
}