Webhooks overview and creation

Usage overview

Webhooks allow you to proactively subscribe to events that occur in your KnowledgeOwl account. When an event occurs that you have subscribed to, we will POST a message to the endpoint of your specification containing information about the event.

Currently we offer 2 types of POST payloads, one formatted specifically for the application Slack, and the other containing KnowledgeOwl API object data.

Create webhooks

To create webhooks in your knowledge base:

  1. Go to Your Account > Webhooks.
  2. Use the + Create New Webhook button to create a new webhook.
    + Create New Webhook button
  3. This will open a New Webhook configuration pop-up.
    New Webhook configuration pop-up
  4. The Knowledge Bases section allows you to select which knowledge bases you'd like this webhook to fire for. All Knowledge Bases is selected by default, but you can check individual knowledge bases to only enable it for specific knowledge bases.
  5. Select one or more Webhook Events. The events you select are what will trigger the webhook. See Available webhook events for more details.
  6. Select the Webhook Type:
    • Slack will send the webhook as a Slack message. See Using Webhooks with Slack.
    • API will send it to any API endpoint of your choice.
  7. Add an appropriate API Endpoint to send the webhook to.
  8. Click Create.

Here's an example of a Slack webhook configured to fire on the KnowledgeOwl and KnowledgeOwl Support knowledge bases when an article is published:
Screenshot of a sample completed New Webhook configuration pop-up with two knowledge bases selected, the article.publish Webhook Event checkbox selected, Slack Webhook Type selected, and a Slack endpoint enteredSample completed New Webhook configuration pop-up

Once you create the webhook, if you've selected a single knowledge base, you can also restrict the webhook to fire on a single category.