Skip to main content
POST
Send batched analytics events to track widget usage and conversion funnels. Max 50 events per batch. Tracking failures never block user flow.

Request

array
required
Array of event objects. Each contains:
  • event (string, required): Event name (e.g. widget:button_click)
  • properties (object, optional): Custom properties
  • timestamp (string, required): ISO 8601 timestamp
  • $insert_id (string, required): Unique ID for deduplication
object
required
Shared context for all events in the batch: page URL, viewport size, user agent, session_id / $pageview_id, and Genlook-specific fields (anonymous_id (anon_*), widget_version (wv_*), widget_enabled, product_id, variant_id).

Event Types

Event names follow category:action format with snake_case.

Response

For non-Shopify integrations (WooCommerce, WordPress, etc.), use the store API route instead:
Authenticate with x-store-api-key. Optional identity headers for logged-in shoppers:
  • x-genlook-customer-id: platform customer id
  • x-genlook-customer-email: customer email
The request body is identical to the Shopify proxy route above.
boolean
required
Whether the batch was processed.