Articles on: Integrations

How to Register a Webhook

How to Register a Webhook


In this article:

  • Overview
  • Before you start
  • How to register a webhook
  • Things to keep in mind
  • FAQs
  • Who can do this


Overview


Webhooks let SuperPath push real-time notifications to your own apps and platforms whenever something happens in your account: for example, when a new user is created, a learner completes some content, or a user earns points. When you register a webhook, SuperPath sends a JSON payload by HTTPS POST to an endpoint URL you control every time one of your subscribed events occurs, so you can keep other systems in sync without polling.


Webhooks are managed in the Manage Webhooks section of Settings → Integrations.


Note: Webhooks are only available on paid accounts. If your account is on a free plan, the Manage Webhooks section shows a message that webhooks are only available for paid accounts, with a link to your Billing settings to upgrade.


Before you start


You will need a publicly accessible HTTPS endpoint ready to receive the webhook payloads. The form only accepts endpoint URLs that start with https://, and SuperPath only sends to public addresses on ports 80 and 443. For details on building and testing a receiving endpoint (the payload shape, returning a 2xx response, and retries), see the developer guide Webhooks - Get updates in real-time.


How to register a webhook


  1. Go to Settings → Integrations and scroll to the Manage Webhooks section.
  2. Click Add Webhook. (On the right, the Webhook documentation link opens the developer guide in a new tab.)
  3. In the Add Webhook window, enter your Endpoint URL. This is required and must be an HTTPS/TLS endpoint: a URL that starts with https://.
  4. Enter a Description so you can recognise the webhook later, for example "Sync new users to our CRM". A description is required.
  5. Under Subscribed events, open the Select events to subscribe to picker and choose one or more events. You must select at least one event. Available events cover create, update and delete across Users, User Teams, Teams, Learnings, Events, Forms, Responses, Content, Points, Comments, Certificates and User certificates, plus an Account updated event.
  6. (Optional) To have SuperPath sign each delivery so your endpoint can verify it, turn on Use webhook signature authentication. See the article How to Secure a Webhook with Signature Authentication for how this works.
  7. Click Add to save the webhook.
  8. If you turned on signature authentication, the Webhook signing secret window opens. Copy the secret key now and put it on your endpoint: it is only shown once.


Once saved, the webhook appears in the webhooks table with its Description, Events, Owner, Last event, Modified, Health and Status. From then on, whenever one of your subscribed events occurs, SuperPath POSTs a JSON payload to your endpoint URL.


Things to keep in mind


  • The endpoint URL must be an HTTPS/TLS endpoint. Non-https:// URLs are rejected by the form, and a URL that points at a private or internal network address is refused when you save.
  • At least one subscribed event is required; a webhook with no events cannot be saved.
  • If your endpoint is briefly unavailable, SuperPath retries each delivery for about 8.5 hours. You can see every attempt with View Webhook Logs. See the help article Webhook Logs: Monitor and Troubleshoot Your Webhooks.
  • For how to receive and parse the payload and return a 2xx response, see the developer guide Webhooks - Get updates in real-time.
  • Webhooks are only available on paid plans.


FAQs


What happens after I register a webhook?
Whenever one of the events you subscribed to occurs in your account, SuperPath sends an HTTPS POST request with a JSON payload to your endpoint URL. Your endpoint should read the event type and payload and return a 2xx response quickly.


Which events can I subscribe to?
Create, update and delete events for Users, User Teams, Teams, Learnings, Events, Forms, Responses, Content, Points, Comments, Certificates and User certificates, plus an Account updated event. See Types of Events for what each one means.


How do I know my webhook is working?
Check the Health column in the webhooks table, or click View Webhook Logs to see each delivery and what your endpoint answered.


Can I secure the webhook so I know it really came from SuperPath?
Yes. Turn on Use webhook signature authentication when adding or editing the webhook, then verify the signature on your endpoint. See the article How to Secure a Webhook with Signature Authentication.


Can I change the URL, description or events later?
Yes. See the article How to Edit or Delete a Webhook.


Who can do this


Only Owners and Admins can register webhooks. Managers, Content Managers, People Managers, Instructors, Employees and Restricted users cannot. The webhooks feature lives under Settings, which is available to Owners and Admins only.

Updated on: 26/10/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!