Skip to main content

Setting Up and Managing Webhooks

Written by Carl Justin Medina

Webhooks let Cloud Assess automatically notify your other business systems — such as your HR platform, CRM, or compliance tool — the moment something important happens in your organisation. Instead of manually exporting data or waiting for a scheduled sync, your external systems receive an update instantly and automatically.

This article explains how to create, manage, and monitor webhooks in Cloud Assess.


Who can do this? Power Users and Admins can create, edit, and delete webhooks. There is no limit on the number of webhooks an organisation can configure.


What is a webhook?

A webhook is an automatic notification that Cloud Assess sends to another system when a specific event occurs. Think of it like a tap on the shoulder — the moment a trigger event happens in Cloud Assess (for example, a learner is enrolled), your external system receives a message straight away and can act on it automatically.

Some examples of what this makes possible:

  • A learner is enrolled in Cloud Assess → your HR system automatically creates or updates their employee training record

  • An assessment is completed → a compliance report is triggered in your reporting tool

  • A unit is finalised → your workforce management system updates the learner's qualification status

The key benefit is that it happens in real time, without anyone needing to export data, run a report, or manually update another system.

📌 Note: Setting up a webhook in Cloud Assess requires an endpoint URL from the external system you want to connect to. This is a web address provided by your IT or developer team that tells Cloud Assess where to send the notification. If you don't have this yet, check with your IT team before proceeding.


Viewing your webhooks

All webhook management is located in Settings → Other Apps.

  1. From the main navigation, go to Settings.

  2. Select Other Apps.

  3. Locate the Webhooks card and click Manage.

This opens the webhooks table, which lists all webhooks currently configured in your organisation. For each webhook, you can see:

Column

What it shows

Name

The label you gave the webhook

URL

The endpoint the notification is sent to

Events

The number of events the webhook is subscribed to

Last Event

The date and time of the most recent notification sent


Creating a webhook

  1. Go to Settings → Other Apps → Webhooks → Manage.

  2. Click Add Webhook. A panel will open on the right-hand side of the screen.

  3. Enter a Name for the webhook. Choose something descriptive so you can identify it easily (for example, HR System — Enrolments or Compliance Tool — Assessment Completions).

  4. Enter the Endpoint URL provided by your IT or developer team. This is the address Cloud Assess will send the notification to.

  5. Select the events you want this webhook to subscribe to:

    • Tick All Events to subscribe to every available event at once — ticking this will automatically select all events below it, and unticking it will deselect them all.

    • Or tick individual events from the list to subscribe to specific triggers only.

  6. Click Save. Your new webhook will appear in the table.

💡 Tip: If you're connecting to more than one external system, create a separate webhook for each. This makes them easier to manage and troubleshoot independently.


Editing a webhook

You can update a webhook at any time — for example, if your endpoint URL changes or you want to add or remove events.

  1. Go to Settings → Other Apps → Webhooks → Manage.

  2. Find the webhook you want to update and click Edit.

  3. Make your changes to the name, endpoint URL, or event selection.

  4. Click Save. Your changes will take effect immediately.


Deleting a webhook

  1. Go to Settings → Other Apps → Webhooks → Manage.

  2. Find the webhook you want to remove and click Delete.

  3. Confirm the deletion when prompted.

⚠️ Note: Deleting a webhook is permanent. Cloud Assess will immediately stop sending notifications to that endpoint. If you're unsure, consider editing the webhook to remove individual events rather than deleting it entirely.


Available events

When setting up a webhook, you can subscribe to any of the following events. Cloud Assess will send a notification to your endpoint each time one of these occurs.

📌 Note: The table below reflects the initial set of available events at launch. Additional events will be added over time.

Event

What triggers it

User Created

A new user account is created in your organisation

Enrolment Created

A learner is enrolled in a unit or course

Assessment Completed

A learner submits or completes an assessment

Unit Completed

A unit of competency is finalised with an outcome

[Additional events — to be added]


What happens if a webhook fails?

If Cloud Assess attempts to send a notification and your external system doesn't respond as expected, Cloud Assess will automatically retry the delivery. This means temporary outages on your endpoint's side won't cause you to miss notifications.

After a set number of retry attempts, Cloud Assess will stop trying. Any failed attempts are recorded in your webhooks table so you can see exactly what happened.

If you notice failed deliveries:

  • Check that your endpoint URL is correct — even a small typo will cause failures

  • Confirm with your IT team that the receiving system is active and accessible

  • Update the endpoint URL in the webhook settings if it has changed

  • If failures persist, your IT or developer team can use an external testing tool such as webhook online checker check whether the endpoint is receiving requests correctly.

View Webhooks Technical Documentation here.


Frequently asked questions

  • Can I have more than one webhook? Yes. There is no limit on the number of webhooks you can configure. You might set up separate webhooks for different systems, departments, or event types.

  • Can I subscribe to the same event across multiple webhooks? Yes. The same event can be used across multiple webhooks. For example, you could have both your HR system and your compliance tool receive a notification when an enrolment is created.

  • Do webhooks work for all user types? Webhooks are configured by Power Users and Admins, but the events they subscribe to can relate to any user in your organisation — learners, assessors, and others.

  • I don't have an endpoint URL — where do I get one? Your endpoint URL is provided by the external system you want to connect to. This is typically set up by your IT or developer team. Cloud Assess also provides technical documentation with payload details to help your team get ready.

  • Can I test a webhook before going live? Cloud Assess does not currently include a built-in webhook testing tool. Your IT or developer team can use a free external service such aswebhook online checker to check that notifications are being received and formatted as expected before connecting to a live system.

Did this answer your question?