Automate connections between systems with webhooks
Use webhooks in LearnUpon to track learner activities automatically.
Availability: depends on your LearnUpon plan
Webhooks let you "listen" for specific events that occur in LearnUpon, like a learner completing a course or failing an exam.
Once you enable the webhook feature, LearnUpon sends event notices (the hooks) as a JSON data POST with defined data schematics, to a URL you provide. You can use these notices in a 3rd-party site or applications.
LearnUpon enables this feature on request. If you can't see the option available in your portal, contact the Support team.
See the webhooks technical documentation.
Note: LearnUpon now supports webhooks version 2.0. Speak to your Customer Success Manager about setup and managing webhook development with version 2.0.
See:
Access permissions
Only admins with full portal permissions can set up and access webhooks.
Turn on webhooks in your portal
When you set up webhooks as a feature, your destination URL receives all the webhooks, for all event triggers that apply to your LearnUpon content and users. You can't turn on a single webhook type.
- From main navigation menu, go to Settings > Integrations > Webhooks.
- From Settings:
- select Enable Webhooks for your portal actions?
- enter an Endpoint URL for LearnUpon to send your webhook events: for example,
https://www.mysite.com/webhook/listening/action - optional: set a shared Secret Key, to verify JSON data coming from LearnUpon's webhooks.
- Save to finish.
Review webhooks manually within the portal
LearnUpon retains all webhooks sent by the application for 30 days. As a troubleshooting option, you can review webhooks sent to your endpoint URL.
You can filter the webhooks, to show those with a specific status of Completed or Pending/Failed, and to show one webhook type at a time.
This webhook status is not related to any enrollment status on a module or a course. It describes only if LearnUpon successfully sent the webhook to the endpoint URL or not.
- From main navigation menu, go to Settings > Integrations > Webhooks.
- From Actions select View Webhooks to see webhooks sent to your endpoint URL in the last 30 days.
- Optional: filter the webhooks by
- Status: Completed or Pending/Failed
- Type: select the webhook type from the dropdown list
- To view an individual webhook’s contents, select the Webhook Type link text.
The following screenshot shows a list of webhooks in a sample portal, with status Completed, and type Module Completed.
See: