Skip to main content
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.
Webhook delivery is only available on paid plans. Free plan organizations cannot register webhook endpoints.

​
Set up a webhook

1

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.
2

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 for the full list.
3

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.
4

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 for a code example.

​
Limits

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