> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Generic webhooks are not available in TruU IDV. Get verification outcomes by polling request status, or receive lifecycle events in ServiceNow through the ServiceNow connector.

This page is for the engineer who wants verification outcomes pushed to their system. When you finish, you know the two paths that exist today and have working polling code.

> [!NOTE]
>
> Generic HTTP webhooks are **not available**. There is no endpoint to register a callback URL, and nothing on this page is a webhook. Use polling or the ServiceNow connector.

## Path 1: Poll request status

Everything an event would tell you is available on the request. `GET /helpdesk/requests/{request_id}` returns the current status plus a full `progress_events` timeline (link delivered, factor attempts and outcomes, fallbacks, final result).

```bash curl theme={null}
curl "https://agent.truu.ai/api/v1/helpdesk/requests/3f9c2a7e-5b14-4d8e-9a61-2c7f0e4b8d35" \
  -H "Authorization: Bearer $ACCESS_TOKEN"
```

```python Python theme={null}
import time

import httpx

BASE = "https://agent.truu.ai/api/v1"
HEADERS = {"Authorization": f"Bearer {ACCESS_TOKEN}"}

TERMINAL = {"verified", "expired", "failed", "cancelled", "declined"}
while True:
    req = httpx.get(f"{BASE}/helpdesk/requests/3f9c2a7e-5b14-4d8e-9a61-2c7f0e4b8d35", headers=HEADERS).json()
    if req["status"] in TERMINAL:
        break
    time.sleep(3)

print(req["status"])
```

Polling guidance:

* Poll every few seconds while a request is open; a help desk link lives 30 minutes, so the worst case is a few hundred calls per request.
* Stop at `expires_at` if you have not seen a terminal state; the request will read `expired` on the next call.
* Honor `Retry-After` on any `429`.

## Path 2: ServiceNow connector

If your help desk runs on ServiceNow, the [ServiceNow connector](https://docs.truu.ai/idv/connect/servicenow.md) pushes every verification lifecycle event to your instance as incident work notes and a status field update. Combined with the [partner links API](https://docs.truu.ai/idv/api/links.md), the round trip works in both directions without polling.

## SIEM and data lake ingestion

For audit rather than per-request outcomes, `GET /admin/audit/events` supports cursor pagination and time-range filters, and `GET /admin/audit/export` produces CSV or JSON Lines (`format=ndjson`). See [Audit events](https://docs.truu.ai/idv/security/audit-events.md) and [Send to your SIEM](https://docs.truu.ai/idv/admin/activity.md#send-to-your-siem).

## Related pages

> [card] [Link creation](https://docs.truu.ai/idv/api/links.md)
>
> Create the request you will poll.

> [card] [ServiceNow](https://docs.truu.ai/idv/connect/servicenow.md)
>
> Pushed events for ServiceNow instances.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.