Skip to main content
Version: v1

Kula Webhook Events and Payloads

This document describes the webhook event payloads that Kula sends to your configured endpoints.

For detailed information on webhook setup, security, and best practices, see the Webhook Guides.

Event Structure​

All webhook events follow a consistent structure:

{
  "event": "resource.action",
  "event_id": "uuid",
  "created_at": "ISO 8601 timestamp",
  "account_id": 12345,
  "data": { ... }
}

Security​

All webhook requests include:

  • X-Kula-Signature: HMAC-SHA256 signature for payload verification
  • X-Kula-Timestamp: Unix timestamp of the request

Retry Policy​

Failed deliveries are retried up to 7 times over ~24 hours with exponential backoff.