Skip to main content
All CollectionsConnecting iQualify to other systemsEvent hub
How to configure webhooks in the Event hub
How to configure webhooks in the Event hub

Account owners can configure webhook endpoints to automate processes or generate reports outside iQualify

Caitlin Foran avatar
Written by Caitlin Foran
Updated over 2 weeks ago

Account owners can set default webhook endpoints to collect events, event data or configure individual events to individual webhooks. 

Any events that have not been individually set and are turned on will send their data payload to the default endpoint.

How to make sure the Event hub is turned on

Head to iQualify settings (found under your avatar) and choose Integrations from the left menu. Then choose Event hub.

Toggle Event Hub to On. This enables the other settings described below.

Screenshot of toggle below Event hub.

How to set a default webhook endpoint

To set a default webhook endpoint, add your webhook endpoint URL under Default global endpoints and toggle Enabled to On.

Screenshot showing steps above: Adding endpoint URL and Enabled toggle set to On.

You can also add custom header data using Add header.

All events that are turned on and do not have an individually set endpoint will send their data payload to this webhook.

How to set a webhook endpoint for an individual event

To set individual event webhooks, first the event Category.

Select a category for your event webhooks

This will show all available events in this category.

In this example Content has been selected.

Content web hook events

Events that are enabled will display a green tick in the corresponding event icon. If that event has been turned off then the icon will display a cross.

Select the event that you want to configure.

In this example we will select Awarded a badge.

Customising an Event Hub endpoint

First ensure that the event is enabled then add your individual webhook endpoints under Endpoints.

As with setting a default endpoint, you can add custom header data using Add header.

How to anonymise event data 

You can also remove data that identifies the users that actioned the event from the payload.

For example you may want to generate statistics about how many times a quiz has been accessed but you are not interested in the identity of those individuals that have accessed it.

To capture the event but anonymise the data, toggle Anonymous to On.

Did this answer your question?