Skip to main content


Set up webhook notifications for incidents

Use webhooks to have HelloID push incident notifications to your web app or other system (e.g., your organization's internal incident monitoring system).

  1. Go to Settings > Company > Incidents > Webhook.

  2. In the Enter Webhook field, enter the webhook URL which should be called for incidents.

  3. Click Add.

    Copy the secret and click OK. In your web app, we recommend verifying the secret, which we send in the X-HelloID-WebHook header.

  4. Click Edit Incident Tags to tag the webhook URL with with the type(s) of incident notifications it should receive. Tags correspond to Incident types. Untagged webhook URLs receive all incident notifications.

  5. Repeat steps (2) - (4) for any other relevant webhook URLs.

  6. Click Save.

The webhook URLs have been added. They will be called:

  • When the incident occurs

  • If the incident remains open:

    • 1 week after

    • 2 weeks after

    • 1 month after

    • 2 months after