FeaturesIntegrationsEarly accessDocsFAQStart free →
Contents: Webhooks

Webhooks

Send every submission as JSON to your own server, CRM or automation tool.

Setup

Go to Integrations → Webhook, enter your endpoint URL and save. Use Send test to check that your endpoint answers with a 2xx status.

Payload

POST /your-endpoint
Content-Type: application/json
X-Formiz-Signature: t=1795000000,v1=5c3f9a…

{
  "id": "sub_8f2k1x",
  "form": "Contact",
  "page": "https://example.com/contact",
  "submitted_at": "2026-11-17T14:02:11Z",
  "fields": {
    "name": "Ayşe Yılmaz",
    "email": "ayse@example.com",
    "message": "Can I get a quote?"
  }
}

Verifying the signature

Compute an HMAC-SHA256 of the timestamp and the raw body with your signing secret, compare it with v1, and reject requests older than five minutes.

verify.js
import crypto from 'node:crypto';

export function verifyFormiz(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest('hex');

  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  const a = Buffer.from(expected);
  const b = Buffer.from(parts.v1 || '');
  return fresh && a.length === b.length && crypto.timingSafeEqual(a, b);
}

Retries

If your endpoint fails or times out, we retry several times with increasing delays. Every attempt is listed in the delivery log.