> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dock.us/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Use webhooks to get real-time notifications on events happening across your Dock workspace.

Webhooks allows you to listen to real-time events happening across your Dock workspace. With webhooks, you can build custom integrations with Dock, such as:

* Sending click events in real-time for further processing
* Triggering a Slack notification when someone clicks on your pitch deck link
* Triggering downstream automations when a workspace is created
* Syncing learner lifecycle updates from `course.completed` and `course.reviewed`
* Tracking library asset views, shares, and downloads

<Info>
  `presentation.viewed` and `presentation.downloaded` are emitted for
  presentation share-link activity only. Asset link activity is available
  through `asset.viewed`, `asset.shared`, and `asset.downloaded`.
</Info>

In this guide, we'll show you how to configure webhooks for your Dock workspace and a list of available events you can listen to.

## Creating a webhook

<Info>You must be an account `admin` to create a webhook.</Info>

To create a webhook for your Dock workspace, you'll need to follow these steps:

<Steps>
  <Step title="Go to your account">
    Go to **Settings** and click on **Webhooks** from the **Data Management**
    section in the side navigation.

    <Frame>
      <img src="https://mintcdn.com/docklabsinc/sOq5EJF8JHZxp7ZE/images/create-webhook-step-1.png?fit=max&auto=format&n=sOq5EJF8JHZxp7ZE&q=85&s=ec5784e2d0b276e89cceaa2e407832a9" alt="Create a webhook on Dock" width="3006" height="1310" data-path="images/create-webhook-step-1.png" />
    </Frame>
  </Step>

  <Step title="Create webhook secret">
    Click on **Create Webhook** button and enter a name to create a webhook in
    your application. Once created, it will appear in the list on the page.

    <Frame>
      <img src="https://mintcdn.com/docklabsinc/sOq5EJF8JHZxp7ZE/images/create-webhook-step-2a.png?fit=max&auto=format&n=sOq5EJF8JHZxp7ZE&q=85&s=499ac21a50c9b34c984f689c6f89f776" alt="Create webhook secret" width="2994" height="1204" data-path="images/create-webhook-step-2a.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/docklabsinc/sOq5EJF8JHZxp7ZE/images/create-webhook-step-2b.png?fit=max&auto=format&n=sOq5EJF8JHZxp7ZE&q=85&s=a3e8de076a96765c5a31d07b978c309a" alt="Create webhook secret" width="2994" height="1204" data-path="images/create-webhook-step-2b.png" />
    </Frame>
  </Step>

  <Step title="Verify webhook target URL">
    Enter the webhook target URL and click on **Save** to verify the webhook
    target URL.

    <Info>
      The webhook target URL must accept a POST request for verification and
      event delivery.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/docklabsinc/sOq5EJF8JHZxp7ZE/images/create-webhook-step-3a.png?fit=max&auto=format&n=sOq5EJF8JHZxp7ZE&q=85&s=e427746231b2111af94a8cbe1c18cb43" alt="Verify webhook target URL" width="2994" height="1204" data-path="images/create-webhook-step-3a.png" />
    </Frame>

    You can click on the **View Key** button to see the secret key. You can use
    this secret key to verify incoming webhook event from Dock incase you have a
    custom implementation to consume webhook events.

    <Frame>
      <img src="https://mintcdn.com/docklabsinc/sOq5EJF8JHZxp7ZE/images/create-webhook-step-3b.png?fit=max&auto=format&n=sOq5EJF8JHZxp7ZE&q=85&s=a7d2c04b6502017467b74763abb796db" alt="Secret key" width="2994" height="1204" data-path="images/create-webhook-step-3b.png" />
    </Frame>
  </Step>
</Steps>
