Events: Subscribe to all our events

JeriCommerce tracks every meaningful customer interaction on your loyalty program. When you connect the Custom API integration, all events are sent as HTTP POST webhooks to your configured endpoint — giving you full flexibility to build custom automations, sync data, or trigger workflows in any system.

‍

‍

Set up

Add your webhook endpoint in Settings → Integrations → API, toggle the Events feature on, and save. From that moment, every customer event fires a POST request to your URL.

‍

‍

Authentication

Every request includes an x-jericommerce-hmac-sha256 header containing a signature encrypted with HMAC-SHA256 using the secret displayed on the integration page. Validate this signature on your server to confirm the request comes from JeriCommerce and prevent spoofing.

The event type is sent in the x-jericommerce-event-type header — use it to route the payload to the right handler.

‍

‍

Retries

If your endpoint returns a non-2xx response, JeriCommerce retries the delivery up to 10 times with exponential backoff. Make sure your endpoint is idempotent so retries don't create duplicate actions.

‍

‍

Base payload

All webhooks share this base structure:

{
  "email": "customer@example.com",
  "id": "event-uuid",
  "customerId": "customer-uuid",
  "campaignId": "campaign-uuid",   // optional
  "url": "https://...",             // optional
  "browser": "Chrome 120",          // optional
  "createdAt": "2026-03-08T12:00:00Z",
  "properties": { ... }             // event-specific data
}

‍

‍

All events

Below is the complete list of 18 events sent to your webhook. The Event name column matches the value in the x-jericommerce-event-type header.

‍

‍

Event properties

Each event includes specific data in the properties object. Here is what you can expect for each event type.

‍

You're all set! Your endpoint will now receive real-time data for every customer interaction on JeriCommerce.