How it works

Webhooks: Real-Time Event Notifications for Your Application

Webhooks provide a seamless way for your application to receive real-time updates about events occurring within the Kvikk system, such as shipment tracking updates. This enables you to automate workflows, synchronize systems, and enhance operational efficiency.

---

How It Works

1. Register a Webhook

   Define a URL endpoint and specify the events you want to subscribe to. Webhooks can be set up directly in the Kvikk App under the Settings menu.

2. Store the Secret

   After creating a webhook, a unique secret key will be generated. This key is used to generate a signature for verifying webhook requests. Note: The secret is shown only once during setup, so store it securely.

3. Receive Event Notifications

   When an event occurs, Kvikk sends a POST request to your webhook URL containing event details.

4. Verify the Signature

   Each request includes an HMAC signature in the headers. Use this signature to validate the authenticity of the webhook payload, ensuring it was sent by Kvikk.

Best Practices

1. Secure the Secret: Treat the webhook secret like a password; never expose it publicly.
2. Use HTTPS: Always configure your webhook endpoint to use HTTPS for secure communication.
3. Handle Retries: Ensure your webhook endpoint is idempotent, as Kvikk may retry requests on failures.
4. Log and Monitor: Log received events for debugging and monitor webhook performance.

With these steps, your integration with Kvikk webhooks will be robust, secure, and highly reliable.