Widget API Reference
Tracking Events
Send analytics events for widget usage and conversion tracking
POST
Send batched analytics events to track widget usage and conversion funnels. Max 50 events per batch. Tracking failures never block user flow.
Authenticate with
Request
array
required
Array of event objects. Each contains:
event(string, required): Event name (e.g.widget:button_click)properties(object, optional): Custom propertiestimestamp(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:x-store-api-key. Optional identity headers for logged-in shoppers:
x-genlook-customer-id: platform customer idx-genlook-customer-email: customer email
boolean
required
Whether the batch was processed.

