v1

latestOpenAPI 3.1.02026-07-134488210.8 KB
Custom 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:

  1. customer.id — Redo customer ObjectId (highest priority)
  2. customer.email — customer email address
  3. 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.