Webhook

Cart optimizer run completed

Fires when a cart-wizard run finishes successfully. Carries a summary of each option (totals + seller count); fetch GET /v1/optimizer/runs/{id} for the full per-seller breakdown.

Body

required

application/json

data
Type: object
required
Properties: 3
eventId
Type: string
required

Idempotency key — stable across delivery retries.
timestamp
Type: stringFormat: date-time
required

An ISO 8601 date-time in UTC, e.g. 2024-08-14T10:23:11.000Z.
type
const:
optimizer.run.completed
required

Responses

2XX

Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

postoptimizer.run.completed

{
  "type": "optimizer.run.completed",
  "eventId": "opt_9f2c1a7b3d4e5f60.completed",
  "timestamp": "2026-07-08T18:44:23.000Z",
  "data": {
    "runId": "opt_9f2c1a7b3d4e5f60",
    "options": [
      {
        "modes": [
          "lowest_price",
          "fewest_sellers"
        ],
        "sellerCount": 6,
        "total": {
          "amount": 222.65,
          "currency": "USD"
        },
        "subtotal": {
          "amount": 208.49,
          "currency": "USD"
        },
        "shipping": {
          "amount": 5.4,
          "currency": "USD"
        }
      }
    ],
    "unmetCount": 0
  }
}

No Body

Acknowledged. Return any 2XX status to ack receipt; non-2XX triggers Svix's retry schedule.

Inventory export finished

Cart optimizer run failed