Subscribe to events and get real-time alerts for changes
Once you have Link with Identity Verification embedded in your app, you should be able to complete an entire session and review it in the dashboard.
To complete your integration, you need to add a webhook receiver endpoint to your application.
To add a webhook, visit the dashboard webhook configuration page and click New Webhook. Note that this is the only setting used to configure Identity Verification webhook receivers; webhook URLs set via
/link/token/create will not be used.
You can select which events you want to subscribe to. For Identity Verification, there are three events:
Enter your webhook receiver endpoint for the webhook you wish to subscribe to and click Save. Plaid will now send an HTTP POST request to the webhook receiver endpoint every time the event occurs, in both the Sandbox and Production environments. If multiple webhook receiver endpoints are configured for an Identity Verification event, webhooks will be sent to all the configured endpoints.
Identity Verification does not guarantee that webhooks will be delivered in any particular order. For example, while the logical ordering of webhooks for a Identity Verification session might look like this:
STEP_UPDATEDThe user has started the Identity Verification session and is on the first step
STATUS_UPDATEDThe user has reached a terminal state for their session
RETRIEDA retry has been requested for this user, either via the dashboard or via API
STATUS_UPDATEDThe retry has been completed
you should be prepared to handle these events in any delivery order. For example, consider whether your application will properly handle:
STEP_UPDATEDevent being delivered after a
STEP_UPDATEDevent being delivered before an associated
In order to properly handle webhook events being delivered out of order, your application should lookup the user's associated session(s) via the
For full webhook information, refer to the API Documentation.