Questions? We have answers.

Using webhooks with Mindbridge

  • Updated

Summary

Webhooks allow you to send real-time alerts from MindBridge to external systems such as Slack, Microsoft Teams, ERP platforms, GRC tools, or BI dashboards. Admin users can configure webhooks in the Admin Portal or via the API to automatically notify other systems when key events like file uploads, analysis completion, or analysis failure occur.

This feature improves operational visibility and helps teams automate downstream workflows without the need for manual monitoring or polling.

Supported webhook events

You can trigger webhook notifications for the following event types:

  • File upload completion

  • Analysis success

  • Analysis failure

  • Missing account mappings

  • Export readiness

  • Engagement creation 

  • User lifecycle events (e.g., user added) 

  • Additional account mapping and analysis triggers 

Create a webhook in the Admin Portal

  1. Go to the Admin panel in MindBridge.

  2. Select the Webhooks tab.

  3. Click Create webhook.

  4. Enter the following required details:

    • Webhook name: A unique, descriptive name for the webhook

    • Destination URL: The endpoint where MindBridge will send the POST request

    • Sidechannel email: An email address to receive alerts if the webhook fails

    • Event types: Select one or more supported events

  5. Click Create webhook.

MindBridge will begin sending POST requests to the specified URL whenever the selected events occur.

Manage webhooks

  • To edit an existing webhook, select it from the list and click Edit

  • To remove a webhook, select it and click Delete

  • To review webhook activity, open the Event Log for auditable request and response history.

API configuration

You can also configure webhooks using the MindBridge API. This requires:

  • Admin-generated bearer token for authentication

  • Use of the webhook management endpoints

Webhook creation, update, and deletion can all be managed programmatically.

Was this article helpful?