Webhooks

Webhooks notify your server when events happen in your shop — orders, customers, products, and inventory. Configure multiple endpoints, each scoped to specific events.

Available events

• order.created — a new order is placed
• order.updated — an order changes
• order.cancelled — an order is cancelled
• order.fulfilled — an order is fulfilled
• customer.created — a new customer signs up
• product.updated — a product changes
• inventory.low — stock drops below threshold

Headers

Each delivery includes these headers so you can verify and route the event:

Verifying the signature

import crypto from 'crypto';

function verifyWebhook(rawBody, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signature),
  );
}

Management endpoints