Webhook

orders.created

An order was placed, or for an offer, the seller accepted it. Requires read:orders.

Headers

webhook-id
Type: stringFormat: uuid
required

Unique ID of the event. Retries of a delivery send the same ID, so use it to deduplicate.
webhook-timestamp
Type: integerFormat: int64
required

When this delivery attempt was sent, as a Unix timestamp in seconds. Each retry sends a new timestamp.
webhook-signature
Type: string
required

Space-separated signatures, each v1, followed by the base64 HMAC-SHA256 of {webhook-id}.{webhook-timestamp}.{body}, keyed with your webhook secret.

Body·OrderCreatedWebhookBody

required

application/json

data
Type: Order
required

The event's data. Its shape depends on the topic.

Properties: 9
seller_id
Type: string
required

The ID of the seller the event belongs to.
timestamp
Type: stringFormat: date-time
required

When the event happened, in ISO 8601. Stable across retries; the webhook-timestamp header is when each attempt was sent.
type
const:
orders.created
required

The webhook topic.
version
const:
v2
required

The payload version.

Responses

200

Acknowledge delivery. Any 2XX status counts.
default

Fail delivery. Non-2XX statuses and timeouts are retried.

postorders.created

{
  "type": "orders.created",
  "timestamp": "2026-10-20T16:00:00.123Z",
  "data": {
    "amounts": {
      "applied_discount": {
        "amount": {
          "amount": "2",
          "currency": "USD"
        },
        "type": "fixed_price"
      },
      "shipping": {
        "amount": "5.99",
        "currency": "USD"
      },
      "subtotal": {
        "amount": "42",
        "currency": "USD"
      },
      "tax": {
        "amount": "3.78",
        "currency": "USD"
      },
      "total": {
        "amount": "49.77",
        "currency": "USD"
      }
    },
    "buyer": {
      "display_name": "Card Collector",
      "id": "6789",
      "username": "cardcollector"
    },
    "created_at": "2026-09-21T12:00:00.000Z",
    "id": "123456",
    "show_id": "0b6f3c1e-8a52-4d2e-9f7a-3c5d1e2f4a6b",
    "status": "pending_fulfillment",
    "transaction_type": "auction",
    "updated_at": "2026-09-21T13:00:00.000Z"
  },
  "version": "v2",
  "seller_id": "1234567"
}

No Body

Acknowledge delivery. Any 2XX status counts.

Orders

orders.updated