Dashboard Webhooks Overview

Truv webhooks enable real-time event notifications, sending updates on employment data and verification tasks to a specified URL.

Setting Up Webhooks in the Truv Dashboard

  1. Access the Webhooks Section:

    • Log in to your Truv Dashboard.
    • Navigate to the Development section and select Webhooks.
  2. Create a New Webhook:

    • Click on "Create a webhook".
    • Enter the URL endpoint where your application will receive webhook notifications.
    • Specify the events you want to subscribe to, such as task-status-update or order-status-updated.
  3. Configure Security Settings:

    • Truv signs each webhook request using a hash-based message authentication code (HMAC) with your Access Secret.
    • Verify the X-WEBHOOK-SIGN header in incoming requests to ensure authenticity.
  4. Save and Test the Webhook:

    • Save your webhook configuration.
    • Test the setup by triggering the subscribed events and confirming that your endpoint receives the notifications.

Managing Webhooks

  • View Existing Webhooks: In the Webhooks section, you can see a list of all configured webhooks, their endpoints, and subscribed events.
  • Edit or Delete Webhooks: Select a webhook to modify its settings or remove it if it's no longer needed.