Skip to content
AtlasBrokers
FeaturesPricingToolsFind BrokersQ&ADocs
Log inGet Started

Ready to modernize your brokerage?

Join brokerages across Canada using AtlasBrokers to close more deals.

Get started free
AtlasBrokers

The modern platform for insurance brokers in Canada.

Product

  • Features
  • Pricing
  • Docs
  • Developers
  • Changelog

Resources

  • Find Brokers
  • Compare Brokers
  • Q&A
  • Glossary
  • Calculators

Company

  • About
  • Blog
  • Careers
  • Security
  • Status

Legal

  • Privacy Policy
  • Terms of Service
  • Compliance
  • Data Processing
  • Privacy Assessment

© 2026 AtlasBrokers Inc. All rights reserved.

Privacy PolicyTerms of Service
DocsWebhooks Guide

On this page

OverviewPayload FormatSignature VerificationEvent CatalogZapier IntegrationMake.com IntegrationRetry Policy

Event Categories

LeadsDealsContactsInvoicesPoliciesBookingsClaimsAddons

Webhooks Guide

AtlasBrokers pushes real-time event notifications to any HTTPS endpoint. Use webhooks to sync external systems, trigger Zapier workflows, build Make.com scenarios, or create custom automations without polling.

How Webhooks Work

  1. 1Register a webhook URL in your workspace under Settings > Webhooks.
  2. 2Select the events you want to subscribe to from the full event catalog.
  3. 3When a matching event fires, AtlasBrokers sends an HTTP POST with a JSON payload.
  4. 4Your endpoint should respond with HTTP 2xx within 10 seconds.
  5. 5Failed deliveries are logged. Use the Replay button to re-send the last event.

Payload Format

Every webhook delivery sends a JSON envelope with consistent top-level fields:

json
{
  "event": "deal.won",
  "timestamp": "2026-03-02T14:23:11.000Z",
  "workspaceId": "ws_abc123",
  "data": {
    "id": "deal_mno321",
    "title": "Home Insurance Policy — Mitchell",
    "value": 2400,
    "currency": "CAD",
    "closedAt": "2026-03-05T09:00:00.000Z"
  }
}
FieldTypeDescription
eventstringThe event type (e.g. deal.won, lead.created)
timestampISO 8601UTC timestamp when the event was fired
workspaceIdstringThe workspace ID that generated the event
dataobjectEvent-specific payload (see Event Catalog for schema)

Signature Verification

When you set a webhook secret, AtlasBrokers signs every delivery with HMAC-SHA256. The signature is sent in the X-Webhook-Secret header. Verify it on your server to confirm authenticity.

Node.js / TypeScript

typescript
import crypto from 'crypto';

function verifyWebhook(
  rawBody: string,     // raw request body string (before JSON.parse)
  secret: string,      // your webhook secret from AtlasBrokers settings
  header: string,      // value of X-Webhook-Secret header
): boolean {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected, 'hex'),
    Buffer.from(header, 'hex'),
  );
}

Python

python
import hmac, hashlib

def verify_webhook(raw_body: bytes, secret: str, header: str) -> bool:
    expected = hmac.new(
        secret.encode('utf-8'),
        raw_body,
        hashlib.sha256,
    ).hexdigest()
    return hmac.compare_digest(expected, header)

Event Catalog

Click any event to see its sample payload. All 15 events are available as webhook triggers.

Leads
Deals
Contacts
Invoices
Policies
Bookings
Claims
Addons

Zapier Integration

Connect AtlasBrokers to 5,000+ apps via Webhooks by Zapier. No custom Zapier app required.

  1. 1In Zapier, create a new Zap and choose "Webhooks by Zapier" as the trigger.
  2. 2Select "Catch Hook" and copy the unique Zapier webhook URL.
  3. 3In AtlasBrokers, go to Settings > Webhooks > New Webhook.
  4. 4Paste the Zapier URL, select your events, and save.
  5. 5In Zapier, click "Test Trigger" — AtlasBrokers will send a test ping.
  6. 6Zapier detects the payload schema. Add your action steps (Slack, HubSpot, Sheets, etc.).

Recommended events for Zapier: lead.created, deal.won, invoice.paid

Make.com Integration

Use Make.com (formerly Integromat) to build visual automation scenarios with AtlasBrokers webhook data.

  1. 1In Make.com, create a new Scenario and add a "Webhooks" module as the trigger.
  2. 2Choose "Custom Webhook" and click "Add" to create a new endpoint. Copy the URL.
  3. 3In AtlasBrokers, go to Settings > Webhooks > New Webhook.
  4. 4Paste the Make.com URL, select the events you want, and save.
  5. 5Back in Make.com, click "Run once" then trigger an event in AtlasBrokers (e.g., create a lead).
  6. 6Make.com captures the payload structure automatically. Build your scenario with filters, routers, and action modules.
  7. 7Set the schedule or leave it as instant to process events in real-time.

Popular Make.com use cases: CRM sync, Slack notifications on deal.won, Google Sheets logging of leads, SMS alerts on claim.filed.

Delivery & Retry Policy

  • Webhooks are delivered with a 10-second timeout per attempt.
  • Non-2xx responses and timeouts are logged as failed deliveries.
  • Failed deliveries are not automatically retried — use the Replay button in Settings to manually re-send.
  • Design your endpoint to handle duplicate events idempotently using the timestamp field.
  • Keep endpoint response times under 3 seconds for reliable delivery.