Skip to main content

Setting Up Webhooks

97 viewsUpdated March 9, 2026By Onbrix Team
webhooksapieventsnotifications

Webhooks

Webhooks send real-time HTTP POST notifications to your server when events occur in Onbrix.

Setting Up a Webhook

  • Go to Settings > Webhooks
  • Click + Add Endpoint
  • Enter your endpoint URL (must be HTTPS)
  • Select which events to subscribe to
  • Save
  • Available Events

  • record.created — A new record is created
  • record.updated — A record is modified
  • record.deleted — A record is deleted
  • Module-specific events for all your active modules
  • Payload Format

    Webhooks send a JSON payload:

    {
    

    "event": "record.created",

    "module": "contacts",

    "record": {

    "id": "abc-123",

    "data": {

    "first_name": "Jane",

    "email": "jane@example.com"

    }

    },

    "timestamp": "2024-01-15T10:30:00Z"

    }

    Signature Verification

    Every webhook includes an HMAC-SHA256 signature in the X-Webhook-Signature header. Verify it to ensure the webhook is from Onbrix:

    const crypto = require("crypto");
    

    const signature = crypto

    .createHmac("sha256", webhookSecret)

    .update(requestBody)

    .digest("hex");

    const isValid = signature === receivedSignature;

    Retry Policy

    If your endpoint returns a non-2xx status code, Onbrix retries with exponential backoff:

  • 1st retry: 30 seconds
  • 2nd retry: 60 seconds
  • 3rd retry: 120 seconds
  • After 3 failed attempts, the delivery is marked as failed. You can view delivery history in the webhook settings.

    Best Practices

  • Always verify the webhook signature
  • Respond with 200 quickly (process asynchronously if needed)
  • Use a queue (like SQS or Redis) for heavy processing
  • Monitor your webhook delivery logs for failures