Skip to main content

Order Created Event

Event Type: order.created

When sent: After successful payment and order creation from your storefront.

NOT sent when: Orders are created via the SDK API (since they come from external sources).

This webhook contains complete order information including items, shipping address, payment method, and totals. Use this for:

Integration Examples:

  • Sync orders to fulfillment systems
  • Send order confirmation emails
  • Update inventory levels
  • Trigger accounting/ERP integration
  • Start shipping label generation
  • Update customer lifetime value

Example webhook payload

Webhook Payload Schema

Order created event data (after successful checkout)

Property
Type
Description
storeIdrequired
string (uuid)
Store identifier
customerId
string (uuid)
Customer identifier
occurredAtrequired
string (date-time)
When the event occurred
externalReference
string
External reference for tracking
orderIdrequired
string (uuid)
Order identifier
orderNumberrequired
string
Order number
checkoutIdrequired
string (uuid)
Checkout identifier that created this order
customer
object
Customer information for webhook events
itemsrequired
object[]
Order line items
shippingAddress
object
Order address DTO for webhook events
billingAddress
object
Order address DTO for webhook events
totalsrequired
object
Order totals DTO for webhook events
paymentMethodrequired
object
Payment method DTO for webhook events
orderStatusrequired
string
Order status
placedAtrequired
string (date-time)
When the order was placed
deliveryInstructions
string
Delivery instructions