Skip to main content

Can I create webhooks in Tribal Habits?

Webhooks can be created in Tribal Habits to send data to external platforms as part of an integration.

Written by David King

Tribal Habits has the ability for all organisations to create webhooks to send data to external platforms as part of an integration.

Note: Only Super Admins can create and manage webhooks.

How can webhooks be enabled?

To enable webhooks in your platform, there is a two step process.

  • Navigate to Admin -> Account -> Subscription and toggle the Webhooks feature on.

  • Reload Admin in your browser and then navigate to Admin -> Accounts -> Integrations and a new Webhook menu option will now be visible.

How are webhooks created?

Navigate to Admin -> Account -> Integrations -> Webhooks to create and manage your webhooks. There is an I want to... menu on the top right of the screen with the option to Create webhook.

When creating a webhook:

  1. Select the webhook event.

    1. Enrolment created. Triggered for any new topic or pathway enrolment

    2. Enrolment completed. Triggered when any topic or pathway is completed

    3. Enrolment updated. Triggered when an admin changes an existing topic or pathway enrolment. This covers changes to the due date of an incomplete enrolment, and changes to the completed date or certified date of a completed enrolment. Resets and retakes do not trigger this event, as they already trigger the Enrolment created and Enrolment deleted webhooks

    4. Enrolment deleted. Triggered when any topic or pathway enrolment is unenroled. This includes a Reset Enrolment (which unenrols and then re-enrols a learner)

  2. Insert the URL for the webhook payload to be sent to. This must be HTTPS. You will use this URL from the platform the payload is being sent to.

  3. Optionally, make any notes about the webhook. This can be useful for identifying why each webhook was created and where it is used.

  4. Enable this webhook. This option allows you to temporarily disable a webhook without deleting it.

How are webhooks managed?

On the same page (Admin -> Account -> Integrations -> Webhooks), there is a table of active webhooks. Admins can:

  • Edit a webhook to update its URL or notes.

  • Edit a webhook to disable it.

  • Edit a webhook to delete it.

  • View the logs of a webhook. The logs show every instance of a webhook occurrence include the date/time, target URL, response and payload information.

What information is sent in the webhook payload?

Please see our Developers documentation for examples of each webhook payload.

Did this answer your question?