Webhooks

What Are Webhooks?

Webhooks allow your application to receive real-time notifications when specific events occur in your ClickBank Command Center account. Instead of polling our API for changes, webhooks push data to your server instantly when events happen.

Common Use Cases

Setting Up Webhooks

Step 1: Create an Endpoint

First, create an endpoint on your server to receive webhook POST requests:

// Node.js / Express example
app.post('/webhooks/clickbank', (req, res) => {
  const event = req.body;
  
  // Verify webhook signature
  const signature = req.headers['x-webhook-signature'];
  if (!verifySignature(event, signature)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Process the event
  switch(event.type) {
    case 'sale.created':
      handleNewSale(event.data);
      break;
    case 'refund.processed':
      handleRefund(event.data);
      break;
    default:
      console.log('Unhandled event type:', event.type);
  }
  
  res.status(200).send('OK');
});

Step 2: Register Your Webhook

Register your webhook URL in your account settings:

1. Go to Settings → Integrations → Webhooks
2. Click "Add Webhook"
3. Enter your endpoint URL (must be HTTPS)
4. Select the events you want to receive
5. Save and copy your webhook secret

Step 3: Verify the Webhook

We'll send a test event to verify your endpoint is working correctly.

Available Event Types

Security Best Practices

const crypto = require('crypto');

function verifySignature(payload, signature) {
  const hmac = crypto.createHmac('sha256', webhookSecret);
  const digest = hmac.update(JSON.stringify(payload)).digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(digest)
  );
}

Troubleshooting