itris Webhooks are set up and managed in the itris Management Utility (IMU) under the Integrations tile.

Introduction

At the point of an event occurring in itris Webhooks are automatically triggered, whereby itris will talk to the configured 3rd party application(s), sending itris data to its endpoints. The 3rd party application(s) can then use this to initiate any number of workflows.

The triggering itris events are the creation of new Applicant, Company, Contact, Job and Placement records. This means for example you can send details of a newly registered or placed applicant to an automation or marketing platform for inclusion in specific communications or journeys such as welcome emails, placement confirmations, make announcements in Microsoft Teams when a placement is made, and much more depending on your needs.

Configuration

A Webhook consists of a URL (for sending data to the 3rd party application), a selection of one or more triggering events and optionally a Signing Secret.

A Signing Secret is string of text of your choosing and if populated, will be used to cryptographically sign all calls to the specified URL. Fundamentally, this adds a layer of validation and security.

Webhooks Calls

Once configured Webhook events are processed approximately every 30 seconds by the itris Agent. Once selected the history of a Webhook is displayed in the events table. If for any reason a call fails, it will be retried 13 times over the next 72 hour period.