v1
latestOpenAPI 3.1.02026-07-134488210.8 KBCustom Events
Bulk create custom events
Create multiple custom events in a single request. Accepts up to 100 events per request.
Each event is validated independently. The response includes per-event results, allowing partial failures — some events may be accepted while others are rejected due to validation errors.
Identity Resolution
Each event resolves customers independently using the same priority order as the single-event endpoint:
- customer.id — Redo customer ObjectId (highest priority)
- customer.email — customer email address
- customer.phoneNumber — customer phone number
At least one identifier must be provided per event. If no matching customer is found, one will be created automatically.
Rate Limiting
This endpoint is rate-limited to 100 requests per second per store.
Requires the customer_events_write scope.
post/stores/{storeId}/events/bulk
Path parameters
storeIdstring required
Example:64e5a8a1af49a89df37e4ee7
Store ID
Request body
Response
Bulk request accepted and queued for processing. No response body is returned.