Skip to main content

How to Create and Manage Webhooks

Learn how to create, configure, and monitor webhooks in Kitchen to receive real-time notifications whenever events occur in your workspace.

Written by Denitsa Zhelyazkova

Webhooks allow Kitchen to notify external applications whenever specific events occur in your workspace.

Instead of repeatedly checking for updates, external systems receive event data automatically, making webhooks ideal for integrations, automations, and custom workflows.

Kitchen attempts to deliver every webhook event up to three times using exponential backoff:

  • First attempt: immediately

  • Second attempt: after 10 seconds

  • Third attempt: after 1 minute and 40 seconds

If a delivery fails, the webhook details page shows when the next retry will occur.

Accessing Webhooks

To manage your webhooks:

  1. Go to Settings.

  2. Select Webhooks.

At the top of the page you'll find these two buttons:

  • Create Webhook — creates a new webhook.

  • View Webhook Docs — opens the Kitchen Webhooks documentation where you can find all supported events, payload examples, and authentication details.

Creating a Webhook

Click Create Webhook to open the webhook configuration window.

For each webhook you can configure:

URL

Enter the endpoint that should receive webhook requests.

Events

Choose which events should trigger the webhook.

Events are grouped by resource, including:

  • Invoices

  • Folders

  • Files

  • Conversations

  • Boards

  • Lists

  • Tasks

  • Documents

  • Embeds

  • Links

  • Quotes

  • Milestones

  • Clients

  • Companies

Each category can be expanded to select one or more individual events.

You can listen for multiple events within a single webhook.

After clicking Save, the webhook will begin listening for the selected events.

Managing Webhooks

The Webhooks page displays all existing webhooks.

For each webhook you can see:

  • URL

  • Error rate

  • Date created

You can sort the list by clicking the URL, Error Rate, or Created column headers.

Repeated clicks toggle between ascending and descending order, with arrows indicating the current sort direction.

By default, webhooks are sorted by Created, with the oldest webhook shown first.

Hover over a webhook to display additional actions.

Edit

Opens the webhook configuration window, where you can:

  • Change the destination URL.

  • Add or remove events.

  • Enable or disable individual event types.

Remove

Permanently deletes the webhook.

Viewing Webhook Activity

Click any webhook in the list to open its details page.

Here you can monitor the webhook's activity and delivery history.

The overview displays:

  • Status

  • Number of events being monitored

  • Signing Secret

By default, the Signing Secret is hidden.

Click Reveal Secret to display it, then use the Copy button to copy the value.

The signing secret can be used to verify that incoming webhook requests were sent by Kitchen.

Viewing Event Deliveries

Below the overview you'll find three tabs:

  • All

  • Succeeded

  • Failed

Selecting an event displays detailed information on the right, including:

  • Event name

  • HTTP response status

  • Response returned by your endpoint

  • Complete webhook request payload

This information is useful when testing integrations or troubleshooting webhook deliveries.

Tip: After creating a webhook, trigger one of the selected events in Kitchen to verify your configuration.

If the endpoint is configured correctly, the event will appear in the webhook activity log along with the full request payload and your server's response, making it easy to confirm that everything is working as expected.

Have more questions? Contact support.

Did this answer your question?