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
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.
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.