​

Webhook Retry Policy

​

What Triggers a Retry

• Your endpoint returns a non-2xx HTTP status code
• Your endpoint doesn’t respond within 30 seconds
• The connection cannot be established
• SSL/TLS handshake fails

​

Retry Schedule

​

Retry Headers

POST /webhooks/kallglot HTTP/1.1
Host: your-app.com
Content-Type: application/json
Kallglot-Signature: t=1711454400,v1=abc123...
Kallglot-Webhook-Id: wh_del_01HXYZ
Kallglot-Retry-Count: 2
Kallglot-Original-Timestamp: 1711454000

​

Idempotency

async function handleWebhook(event) {
  // Check if already processed
  const processed = await db.webhookEvents.findOne({ eventId: event.id });
  if (processed) {
    console.log(`Event ${event.id} already processed, skipping`);
    return;
  }

  // Process the event
  await processEvent(event);

  // Mark as processed
  await db.webhookEvents.insert({
    eventId: event.id,
    processedAt: new Date()
  });
}

​

Monitoring Deliveries

​

Developer Portal

1. Go to Webhooks > select your endpoint
2. Click Delivery History
3. View status, response, and retry history for each event

​

Delivery Statuses

​

Webhook Events

{
  "type": "webhook_endpoint.disabled",
  "data": {
    "endpoint_id": "wh_01ABC",
    "url": "https://your-app.com/webhooks",
    "reason": "too_many_failures",
    "failed_events": 100
  }
}

​

Automatic Disabling

• 100 consecutive failed deliveries, or
• 7 days of continuous failures

1. Fix the underlying issue
2. Go to Developer Portal > Webhooks
3. Select the disabled endpoint
4. Click Re-enable

​

Best Practices

app.post('/webhooks', (req, res) => {
  // Verify signature
  // ...

  // Queue for processing
  queue.add(req.body);

  // Return immediately
  res.status(200).send('OK');
});

app.post('/webhooks', async (req, res) => {
  await sqs.sendMessage({
    QueueUrl: WEBHOOK_QUEUE_URL,
    MessageBody: JSON.stringify(req.body),
    MessageDeduplicationId: req.body.id
  });

  res.status(200).send('OK');
});

async function handleSessionEvent(event) {
  const session = await db.sessions.findOne({ id: event.data.id });

  // Only process if this event is newer
  if (session && event.created_at <= session.lastEventAt) {
    console.log('Skipping stale event');
    return;
  }

  await processEvent(event);
}

​

Manual Retry

1. Go to Webhooks > select endpoint > Delivery History
2. Find the failed event
3. Click Retry

​

Event Expiration

• Events cannot be viewed in the Developer Portal
• Manual retries are no longer possible
• The event data is permanently deleted