Receiving Webhooks for Telnyx Verify

You can choose to be notified about events on your send verifications by configuring webhooks on your verify profile.

---

The Telnyx Verify Service will attempt to notify you about the following delivery events for the send verification request:

• verify.sent
• verify.failed
• verify.delivered

Here is an example of a webhook event where a delivery receipt is returned to the sender after sending a verification:

{
  "data": {
    "event_type": "verify.delivered",
    "id": "010d9dee-d86d-47d0-8d6c-20c0f95a79ec",
    "occurred_at": "2025-10-08T17:16:09.602+00:00",
    "payload": {
      "created_at": "2025-10-08T17:16:08.436941",
      "custom_code": "25565",
      "delivery_status": "delivered",
      "extension": null,
      "failed_attempts": 0,
      "id": "010d9dee-d86d-47d0-8d6c-20c0f95a79ec",
      "mccmnc": null,
      "phone_number": "+13125000000",
      "profile_id": "49000192-1bdb-c56f-3de7-e008ef6da16b",
      "record_type": "verification",
      "status": "pending",
      "timeout_secs": null,
      "type": "sms",
      "updated_at": "2025-10-08T17:16:09.592765"
    },
    "record_type": "event"
  },
  "meta": {
    "attempt": 1,
    "delivered_to": "https://webhook.site/af3a92e7-e150-442c-9fe6-61658ce26b1a"
  }
}

Delivery Status	Description
sent	The verification has been sent to the upstream provider.
delivered	The upstream provider has confirmed delivery of the verification.
sending_failed	Telnyx has failed to send the verification to the upstream provider. Please reach out to our support if you have received this status.
delivery_failed	The upstream provider has failed to send the verification to the receiver. Please reach out to our support if you have received this status.
delivery_unconfirmed	There is no indication whether or not the verification has reached the receiver. Please reach out to our support if you have received this status

---

If you use an ACL or Firewall on your network, make sure you whitelist the following subnet(s):

192.76.120.192/27