Setting Up Webhooks

Webhooks send real-time notifications to your server when events occur.

Example Events:

• Contact replies to SMS
• Mail piece delivered
• New lead created
• Campaign completed

• Go to Settings > API > Webhooks
• Click "Add Webhook"
• Enter your endpoint URL
• Select events to receive
• Save and test

Webhooks send JSON payloads:

{
  "event": "sms.received",
  "timestamp": "2026-01-29T12:00:00Z",
  "data": {
    "contact_id": "abc123",
    "message": "Yes, I'm interested!",
    "from": "+15551234567"
  }
}

We sign all webhooks with HMAC-SHA256.

Verify using the `X-Trackably-Signature` header:

const crypto = require('crypto');
const signature = crypto
  .createHmac('sha256', webhookSecret)
  .update(payload)
  .digest('hex');