Summary
Use webhooks in LearnUpon to track learner activities automatically.
This feature is available depending 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.
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: