Webhooks
Exploring Webhooks and how to Configure them within the UI.
What is a Webhook?
When a specific event occurs in your instance of Content Controller. Automatically notify your system with all relevant information.
Available Webhooks
We offer a variety of webhooks to utilize. Below are each topic and the subtopics within.
Looking for more technical documentation? Check out this article here.
Configuring Webhooks
To view an existing or configure a new webhook please follow these steps.
Navigating to the Webhooks Page
Click the Gear Icon in the upper right corner and select Administration.
Navigate to the Integrations tab.
Select "Webhooks" on the left side navigation.
Adding a new Webhook
Step 1 | Initial Setup
While on the Webhooks listing page. Click on the + Add button in the top right of the page.
Enter a Name to help describe the webhook.
Enter a fully qualified URL endpoint to receive the webhook messages.
(Optionally) Set the Key & Secret if authentication is required to access the endpoint.
Select your Topic which is the main class of events for which you want to receive notifications. Reference the list of webhooks above to better understand your required topic.
(Optionally) Select your Focus to better narrow down the topic to only get notifications for specific resources.
Set Active status (this defaults to active). In some situations you may desire the webhook to be ‘off’ while you prepare things.
Click on Next
Step 2 | Accounts (if applicable)
If chosen as a Focus. Make your selection for Account(s) that this webhook will apply to.
Step 3 | Content (if applicable)
If chosen as a Focus. Make your selection for Content that this webhook will apply to.
Step 4 | Subtopics
Select all subtopics that apply. By default all will be selected. These offer the more granular choice of event types that trigger for the webhook.
Step 5 | Summary
Here you are given a overview of the webhook that will be created. Once reviewed click on the Create button to complete the setup. The new webhook will appear on the listing page.
Editing a Webhook
To edit a webhook simply click on the desired item in the list view. Then click on the Edit button. This will bring up a modified version of the creation wizard where you may make your changes. Please ensure that you follow the wizard to the end and select Save.
Deactivating a Webhook
If you wish to Deactivate (to turn off) a webhook. Simply Click on the desired webhook on the listing page and select the “Deactivate” option at the top of the edit panel. Then confirm the presented modal.
Deleting a Webhook
To delete a webhook it must first be Deactivated (see above). Once a webhook has been deactivated a new Delete Webhook option will appear. Clicking this will once again prompt a modal, confirm deletion.
Important Notice: This will completely remove the webhook from your instance of Content Controller and cannot be recovered.
Viewing an Inactive Webhook
When a webhook is deactivated. It will disappear from the Active list of webhooks. To find any inactivated webhooks you must select the filter drop down at the top of the listing page.
Troubleshooting Webhooks
If there ever is an issue with your webhook. We will attempt to communicate with an Alert on the webhook listing page in the Content Controller application itself. A hazard icon will be displayed next to the webhook in question. By clicking on said webhook we will attempt to describe what is causing the error in the details panel. This will be noted in a gold encapsulated message. This message is crafted based on the error code we receive from the customer system.
Last updated
