Webhooks version 2.0: setup

Track automatic notifications about portal events

LearnUpon’s webhooks version 2.0 notify you of course changes and learner activities, so you can automate processes in your organization.

Availability: depends on your LearnUpon plan

Contact your Implementation Consultant or Customer Success Manager to turn on webhooks version 2.0 in your portal.

See the webhooks version 2.0 technical documentation.

Webhooks let you "listen" for specific events that occur on your LearnUpon portal, like a learner completing a course or a manager enrolling a learner. Once you set up webhooks, LearnUpon sends event notices (the hooks) to a defined URL, as a JSON data POST, with defined data schematics. You can use these notices in your third-party site or applications.

Notable features of webhooks version 2.0

Version 2.0 aims to provide the right information in a webhook, and avoid sending redundant information that you don't need to complete an action. Some changes include:

• customers can choose the webhooks they need for their integrations, and not receive webhook traffic they don't use
• sending optimized required learner details to complete the webhook transaction, and allow customers to build integrations
• sending a single webhook type to cover different module completions
• sending multiple webhooks of the same type in a single payload. For example, combining multiple module completions into a single message provides the same required information with less webhook traffic
• moving metadata into the header, in line with industry standards. Using the header effectively means customers can verify the webhook integrity without parsing the contents

Access permissions

• admins with full portal permissions: can set up and access webhooks

For sub-portals, you set up webhooks separately for each portal.

Turn on webhooks in your portal

When you set up webhooks as a feature, your destination URL receives the webhooks you choose, for the event triggers that apply to your LearnUpon content and users.

1. From main navigation menu, go to Settings > Integrations > Webhooks v 2.
2. 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
3. Select the hooks you need for your automated processes.
4. Save to finish.

The following screenshot shows the webhooks v2 interface in LearnUpon.

See:

• Build custom integrations category