⚡ Webhooks Configuration

Subscribe to archive events, automate crawls, and receive real-time notifications for domain changes and restoration tasks.

🌐 Endpoint URL
Active
Used to verify payload signatures
📡 Subscribed Events
4 Active
  • ✓
    page.archived
    Triggered when a URL is successfully crawled & stored
  • ✓
    crawl.completed
    Batch crawl job finishes processing all queued URLs
  • domain.expired
    Watched domain registration expires or goes offline
  • ✓
    metadata.updated
    Archive tags, descriptions, or preservation status changes
  • ✓
    export.ready
    WARC/HTML export bundle is ready for download
📦 Payload Structure
{
  // Webhook Event Payload

  "id": "evt_8f3a2b1c9d0e",
  "event": "page.archived",
  "timestamp": "2024-03-15T14:32:08Z",
  "data": {
    "url": "https://geocities.com/Area51/Retrowave",
    "status": "200",
    "size_bytes": 42853,
    "format": "warc1.1",
    "preservation_tier": "gold"
  },
  "signature": "sha256=8f3a...c9d0"
}
🔐 Signature Verification

All payloads are signed using HMAC-SHA256. Verify the X-1990-Signature header before processing.

  • • Header: X-1990-Signature: sha256={hash}
  • • Algorithm: HMAC-SHA256
  • • Secret: Your webhook secret key
const crypto = require('crypto');
const valid = crypto.createHmac('sha256', secret)
  .update(payload)
  .digest('hex');
// Compare with header signature
📜 Delivery Logs
Status Event Response Timestamp ID Action
Delivered page.archived 200 OK 2024-03-15 14:32:08 del_9f8e7d6c
Failed crawl.completed 502 Bad Gateway 2024-03-15 13:15:42 del_8e7d6c5b
Delivered metadata.updated 200 OK 2024-03-15 11:04:19 del_7d6c5b4a
Pending export.ready — 2024-03-15 09:22:01 del_6c5b4a3z