Webhooks Setup

Receive real-time events from AmDital via webhooks.

Register a Webhook

Configure webhook endpoints in your workspace settings to receive events.

POST ${API_URL}/webhooks
{
  "url": "https://example.com/webhooks/amdital",
  "events": ["task.created", "invoice.paid", "ticket.resolved"]
}

Signature Verification

Every webhook payload includes an X-Signature-256 header. Verify it using your webhook secret with HMAC-SHA256.

const crypto = require('crypto')
const sig = req.headers['x-signature-256']
const expected = crypto
  .createHmac('sha256', WEBHOOK_SECRET)
  .update(JSON.stringify(body))
  .digest('hex')
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
  throw new Error('Invalid signature')
}

Retry Policy

AmDital retries failed deliveries up to 3 times with exponential backoff (10s, 60s, 300s). After 3 failures, the event is marked as failed and visible in the webhook logs.