Skip to main content

Event webhooks

Kisi offers the possibility to send events to third-party services using an HTTP webhook. When an event is added to the stream of a place, an Event Webhook is triggered, in turn dispatching the event payload as JSON to an external endpoint as specified by the webhook integration's url field.

Prerequisites

  • Kisi organization administrator rights
  • A URL to post to

Set up the integration

  1. Sign in to Kisi
  2. Under Organization Setup, click on Integrations
  3. Click on Add Integration
  4. Define the name of your new event webhook integation
  5. Open the Type dropdown and select Event Webhook
  6. In the URL field, enter the destination URL
  7. Optional: if a signature key is provided, it will be used to calculate an HMAC-SHA256 digest of the JSON in the body of the HTTPs request. The digest is then sent along with the X-Signature header
  8. Optional: you can select the event types that should trigger the event webhook
  9. Click Save. The integration will take effect immediately.

From this point forward, any activities from the events stream will forward to the webhook integration.

info

Webhook endpoints may sometimes receive the same event multiple times. To prevent duplicate event notifications, we recommend that you make your event handling idempotent. For example, you can log the events you’ve processed, and then not process the already logged ones.