1. [    Home ](/)
2. [Documentation](/docs)
3. [Webhooks](/docs?category=10)
4. Webhooks Integration Guide
 
 Webhooks v2.0      8 min read  

# Webhooks Integration Guide

  A  admin  March 5, 2026   (Updated April 22, 2026)  

 

 

 JavaScript Python Ruby 

 

 

Image

   ![Webhooks Integration Guide](/sites/default/files/styles/16_9_512x288_focal_point_webp/public/doc-images/webhooks-integration-guide.png.webp?itok=oD_KlN_Q "Webhooks Integration Guide") 

 





 

 

  ## On this page

  
  [    Back to top ](#main-content) 

 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.



 

 

 

 ### Tags

 

 

  [     Previous Advanced Query Patterns  ](/docs/advanced-query-patterns) [  Next JavaScript SDK Reference     ](/docs/javascript-sdk-reference)