Skip to main content
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.
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).
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 pushes every verification lifecycle event to your instance as incident work notes and a status field update. Combined with the partner links API, 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 and Send to your SIEM.

Link creation

Create the request you will poll.

ServiceNow

Pushed events for ServiceNow instances.