Webhooks

Webhooks let you send ioZen data to your own systems whenever something happens.

Setting Up Webhooks

1. Go to Settings → Integrations → Webhooks
2. Click Add Webhook
3. Enter your endpoint URL
4. Select which events to send
5. Save

Events

Event	Triggered When
submission.created	New IntakeBot submission
submission.updated	Submission data modified
card.created	Card created on Process Board
card.moved	Card moved to new phase
contact.created	New contact created
contact.updated	Contact data modified

Payload Format

{
  "event": "submission.created",
  "timestamp": "2026-01-27T12:00:00Z",
  "flowAppId": "fa_123abc",
  "data": {
    "id": "sub_456def",
    "fields": {
      "name": "John Doe",
      "email": "john@example.com"
    },
    "contact": {
      "id": "con_789ghi",
      "email": "john@example.com"
    }
  }
}

Security

Webhooks include a signature header for verification:

X-ioZen-Signature: sha256=abc123...

Verify the signature by computing HMAC-SHA256 of the payload with your webhook secret.

Retry Policy

Failed webhooks are retried:

• 3 retries over 24 hours
• Exponential backoff
• Failed webhooks logged in Settings

Need help? Email hello@iozen.ai.