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

# Webhooks Overview

> Send KeyPort license events to your own services in real time.

Webhooks let your server receive HTTP POST requests whenever license events occur in your KeyPort organization. Instead of polling the API for changes, KeyPort pushes event data to an endpoint you control.

<Note>
  Webhook delivery is only available on paid plans. Free plan organizations cannot register webhook endpoints.
</Note>

## Set up a webhook

<Steps>
  <Step title="Create an endpoint in the dashboard">
    Go to **Settings → Webhooks** in the KeyPort dashboard and click **Add Endpoint**. Enter the publicly accessible URL of your server that will receive event deliveries.
  </Step>

  <Step title="Choose events to subscribe to">
    Select the event types you want to receive. You can subscribe to individual events or all events in your organization. See [Events](/webhooks/events) for the full list.
  </Step>

  <Step title="Store your signing secret">
    After saving the endpoint, KeyPort generates a signing secret in the format `whsec_...`. Copy this value and store it securely — for example, as an environment variable on your server. You will not be able to view it again from the dashboard.
  </Step>

  <Step title="Verify signatures on every delivery">
    Use your signing secret to verify the `X-KeyPort-Signature` header on each incoming request before processing the payload. See [Payloads & Signing](/webhooks/payloads-and-signing) for a code example.
  </Step>
</Steps>

## Limits

* You can register a maximum of **10 webhook endpoints** per organization.
* Each endpoint can subscribe to any combination of available event types.