Managing External Webhooks

You can add new webhooks, update existing configurations, or delete webhooks that are no longer needed from the Manage Webhooks page.

Permissions may be required to access some pages in Degreed or perform specific tasks. For more information, see Permissions in Degreed.

Required Permission: Manage Webhooks

• To Add a Webhook
• To Edit a Webhook
• To Delete a Webhook

To Add a Webhook

1. From the side navigation menu in Degreed Admin, select Integrations > Webhooks.
   The Webhooks dashboard displays.
2. Click Add Webhook.
   The Add Webhook page displays.
3. Select the Status of the webhook configuration.
4. Enter a Webhook Name.
5. Enter the Endpoint URL.

6. Select the Authorization Type.

   • Oauth 2: Enter the Client ID, Client Secret, and Client URL.
   • HMAC: Enter the Signature Header and HMAC Secret. The Signature Header will be encrypted with SHA-256 in Base 64. The HMAC Secret is also known as the signing key and will be encrypted with SHA-256.
   • Basic: Enter the Username and Password.
7. Click the Events tab.
8. Click the toggle for each event you want to subscribe to from off to on:
9. Click Save.
   The External Webhooks Configuration is saved and the system sends a test message to your endpoint to verify that it is working and capable of receiving messages. ​​If your endpoint did not respond to the test message, an error message displays. After you correct the issue, click Try Again. 

To Edit a Webhook

1. From the side navigation menu in Degreed Admin, select Integrations > Webhooks.
   The Webhooks dashboard displays.
2. Click Manage Webhooks.
   The Manage Webhooks page displays.
3. Click the webhooks configuration you want to update.
   The webhook details page displays.
4. Click Edit.
   The Edit Webhook page displays.
5. Edit the webhooks configuration.
6. Click Save.
   The webhooks configuration is saved and the system sends a test message to your endpoint to verify that it is working and capable of receiving messages. ​​If your endpoint does not respond to the test message within 5 seconds, an error message displays. After you correct the issue, click Try Again.

To Delete a Webhook

When you delete a webhooks configuration, the action is permanent and cannot be undone. If you want to restart a webhook instead of deleting it, set the webhook status to Paused.

1. From the side navigation menu in Degreed Admin, select Integrations > Webhooks.
   The Webhooks dashboard displays.
2. Click Manage Webhooks.
   The Manage Webhooks page displays.
3. Click the webhooks configuration you want to remove.
   The Webhook Details page displays.
4. Click Delete .
   A confirmation message displays.
5. Click Delete.
   The webhooks configuration is deleted.