Launch Week Day 3: Webhooks

Today we're launching webhooks for Zinc 2.0.

Configure a URL in the dashboard, and we'll send you an HTTP request whenever something happens to your order. Order started. Order placed. Order failed. Tracking received.

No more polling the API in a loop waiting for status changes.

Why this matters

A lot happens after you submit an order. The retailer confirms it. They pick and pack. They create a shipping label. The carrier picks it up. Each step can take minutes, hours, or days, and your customers want to know what's going on.

Without webhooks, you're polling. Hitting the API over and over, waiting for something to change.

The real pain isn't the wasted API calls. It's the lag. Your customer asks "where's my order?" and your system doesn't know yet because you're polling every 10 minutes and the update came in 9 minutes ago. Or you're polling once an hour to save resources and now you're 59 minutes behind.

Webhooks fix this. We tell you the moment something changes.

How it works

Configure your webhook URL in the Zinc dashboard under Settings. One endpoint, all events. If you used v1 webhooks, this is simpler. No more separate URLs for each event type.

Once configured, we'll POST to your URL whenever an event occurs:

{
  "event": "order.placed",
  "order_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "order_placed",
  "timestamp": "2026-01-15T14:30:00Z",
  "data": {
    "price_components": {
      "subtotal": 1999,
      "shipping": 499,
      "tax": 150,
      "total": 2648
    }
  }
}

We send webhooks for the key moments in an order's lifecycle:

• order.started — order created and queued for processing
• order.placed — order successfully placed with the retailer
• order.failed — order failed after all retry attempts exhausted
• order.tracking_received — tracking number received from the retailer

Each event includes relevant data: price components when the order is placed, error details if it fails, carrier and tracking number when tracking arrives.

Try it for yourself!

Configure your webhook URL in the dashboard under Settings. Create a test order and watch the events come through.

For payload structure, signature verification, and best practices, check out Webhooks in our docs.

Tomorrow we're shipping the feature your support team has been asking for.