Webhooks Enterprise

Real-time event notifications

Available Events

Webhook Payload

{
  "event": "carbon.updated",
  "timestamp": "2026-01-16T00:15:00Z",
  "data": {
    "feed_name": "carbon_intensity",
    "networks_updated": 54,
    "snapshot_id": "snap_abc123"
  },
  "meta": {
    "webhook_id": "wh_xyz789",
    "delivery_attempt": 1
  }
}

Setup

Configure your webhook endpoint in the Enterprise Dashboard:

1. Go to Settings → Webhooks
2. Add your HTTPS endpoint URL
3. Select events to subscribe
4. Copy the signing secret

Security

Verify webhook authenticity using the signature header:

X-FeedOracle-Signature: sha256=abc123...

Python Verification

import hmac
import hashlib

def verify_signature(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(f"sha256={expected}", signature)

Retry Policy

After 5 failed attempts, the webhook is paused and you receive an email alert.

Requirements

• HTTPS endpoint (TLS 1.2+)
• Respond with 2xx within 30 seconds
• Handle duplicate deliveries (idempotency)
• Store webhook_id to detect duplicates