Bulk create custom events

curl --request POST \
  --url https://api.getredo.com/v2.2/stores/{storeId}/events/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "eventName": "User Registered",
      "customer": {
        "email": "alice@example.com"
      },
      "data": {
        "Plan Type": "premium"
      }
    },
    {
      "eventName": "Purchase Completed",
      "customer": {
        "email": "bob@example.com"
      },
      "data": {
        "Order Total": 99.99,
        "Item Count": 3
      },
      "value": 99.99,
      "valueCurrency": "USD",
      "uniqueId": "order-456"
    }
  ]
}
'

{
  "detail": "<string>",
  "instance": "<string>",
  "title": "<string>",
  "type": "about:blank"
}

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:

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.

POST

stores

{storeId}

events

bulk

Bulk create custom events

curl --request POST \
  --url https://api.getredo.com/v2.2/stores/{storeId}/events/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "eventName": "User Registered",
      "customer": {
        "email": "alice@example.com"
      },
      "data": {
        "Plan Type": "premium"
      }
    },
    {
      "eventName": "Purchase Completed",
      "customer": {
        "email": "bob@example.com"
      },
      "data": {
        "Order Total": 99.99,
        "Item Count": 3
      },
      "value": 99.99,
      "valueCurrency": "USD",
      "uniqueId": "order-456"
    }
  ]
}
'

{
  "detail": "<string>",
  "instance": "<string>",
  "title": "<string>",
  "type": "about:blank"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

storeId

string

required

Store ID

Example:

"64e5a8a1af49a89df37e4ee7"

Body

application/json

Request body for sending multiple custom events in a single request.

events

Custom Event Request · object[]

required

Array of custom events to create.

Required array length: 1 - 100 elements

Show child attributes

Response

Bulk request accepted and queued for processing. No response body is returned.

Create custom event

Navigate to Customer Portal