Skip to main content
Webhook configurations are tied to your API key. If you switch from sandbox keys to production keys, you must re-configure your webhooks under the new key.

Events

  • USER_VERIFICATION_COMPLETED: the user has successfully completed verification.
  • USER_VERIFICATION_REVOKED: a user voluntarily revoked their connection to the company.
  • USER_VERIFICATION_DENIED: the company denied a user’s verification request (e.g., after reviewer rejection).
  • USER_VERIFICATION_DETERMINED_UNFULFILLABLE: the verification cannot be fulfilled.
USER_VERIFICATION_REVOKED vs USER_VERIFICATION_DENIED: These events represent two different disconnection flows:
  • Revoked: The user initiates the disconnection by voluntarily revoking their verification.
  • Denied: The company initiates the rejection by denying the user’s verification request.
Subscribe to both if you need to track all verification terminations.

Payload

Signature verification

Each webhook includes an X-Hub-Signature-256 header in the format sha256=<hex>. Compute the HMAC over the raw JSON body using your webhook shared secret.
Node.js (Express)

Retries

Failed deliveries are retried with exponential backoff, up to 16 total attempts. The backoff caps at 6 hours.

Admin endpoints

Create or edit a webhook

List configured webhooks

Returns an array of configured webhooks, each with webhook_type and destination_url.

Delete a webhook

List recent webhook calls

Returns up to 50 recent webhook calls with transaction_id, webhook_type, status (PENDING, COMPLETED, or FAILED), attempts, and timestamps.

Rerun a webhook call

The rerun creates a new webhook call with its own new transaction_id.

List recent webhook events

Returns up to 50 recent webhook call events including HTTP status, response body, and network failure information.