Webhook

Order created

​

Fires when a new order is placed. Delivered to both the seller and the buyer, with the payload shaped per role (recipientRole: "buyer" | "seller").

Body
required
application/json
  • data
    Type: object
    required

    Order details, shaped for the recipient role.

  • eventId
    Type: string
    required

    Idempotency key. Stable across retries of the same delivery; safe to dedupe on.

  • recipientRole
    Type: string enum
    required

    Whether this delivery is for the seller or the buyer side of the order. The same order produces two deliveries — one to each role.

    values
    • seller

      You received this because you're the seller.

    • buyer

      You received this because you're the buyer.

  • timestamp
    Type: string Format: date-time
    required

    When this webhook was emitted (ISO 8601, UTC).

  • type
    const:  
    order.created
    required
Responses
  • 2XX

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

Request Example for postorder.created
{
  "type": "order.created",
  "eventId": "OR-ASNBC-1.seller",
  "timestamp": "2026-05-09T14:23:11.000Z",
  "recipientRole": "seller",
  "data": {
    "orderNumber": "OR-ASNBC-1",
    "status": "pending_shipment",
    "currency": "EUR",
    "totalAmount": {
      "amount": 42.5,
      "currency": "EUR"
    },
    "itemCount": 2,
    "items": [
      {
        "productId": 50212,
        "name": "Black Lotus",
        "quantity": 1,
        "unitPrice": {
          "amount": 40,
          "currency": "EUR"
        },
        "inventoryId": "665f3a2b1c8d4e9f7a6b5c4d",
        "customId": "MTG|LEB-232-nm-en"
      },
      {
        "productId": 50213,
        "name": "Lightning Bolt",
        "quantity": 1,
        "unitPrice": {
          "amount": 2.5,
          "currency": "EUR"
        },
        "inventoryId": "665f3a2b1c8d4e9f7a6b5c52",
        "customId": null
      }
    ],
    "counterparty": {
      "username": "buyer_jane",
      "country": "FR"
    },
    "createdAt": "2026-05-09T14:23:10.000Z"
  }
}
No Body

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