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.
Payload
Signature verification
Each webhook includes anX-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
webhook_type and destination_url.
Delete a webhook
List recent webhook calls
transaction_id, webhook_type, status (PENDING, COMPLETED, or FAILED), attempts, and timestamps.
Rerun a webhook call
transaction_id.