Webhooks

Real-time notifications for sync events. Status: Coming Q1 2026

Webhook Events

When available, you'll receive:

• sync.completed - Sync finished

• retailer.connected - New retailer linked

• orders.new - New orders detected

For Now: Polling

Until webhooks launch, poll for sync status:

async function pollSync(syncBatchId, token) {
  const response = await fetch(
    `https://sync.brandclub.com/sync/sessions/${syncBatchId}`,
    { headers: { Authorization: `Bearer ${token}` } }
  );

  const session = await response.json();

  if (session.status === "completed") {
    // Fetch new orders
    const orders = await fetchOrders(token);
    updateRewards(orders);
  } else if (session.status === "syncing") {
    // Poll again in 5 seconds
    setTimeout(() => pollSync(syncBatchId, token), 5000);
  }
}

Future Webhook Format

When available:

POST https://yourapp.com/webhooks/brandclub
{
  "event": "sync.completed",
  "sync_batch_id": "batch_xyz789",
  "retailer_id": 1,
  "orders_found": 12
}

Signature verification will be required (details TBA).