Webhooks Integration Guide

Webhooks allow your application to receive real-time notifications when events occur in the Connectbase platform. Instead of polling the API, register a webhook endpoint and we will push events to you.

Supported Events

• building.created — A new building record is added
• building.updated — Building data changes
• address.validated — An address validation completes
• network.status_changed — Network availability changes at a location
• subscription.renewed — An API subscription is renewed

Setting Up Your Endpoint

Your webhook endpoint must accept POST requests with a JSON body. Register your URL in the Developer Portal under Settings → Webhooks.

Signature Verification

Every webhook includes a X-Connectbase-Signature header. Verify this signature using your webhook secret:

const crypto = require('crypto');\nconst signature = crypto\n .createHmac('sha256', webhookSecret)\n .update(rawBody)\n .digest('hex');\n\nif (signature !== req.headers['x-connectbase-signature']) {\n return res.status(401).send('Invalid signature');\n}

Retry Policy

Failed deliveries (non-2xx responses) are retried up to 5 times with exponential backoff: 1min, 5min, 30min, 2h, 24h.