Connect
Webhooks
A Send webhook step posts every submission that reaches it to your address as JSON, signed so you can be sure it came from Formera.
The payload
POST body
{
"event": "submission.created",
"submission_id": "sub_7k2m9x4q1w3e5r6t",
"form": { "id": "frm_q8w2e4r6t1y3", "name": "Quote request" },
"source": { "id": "src_m3n5b7v9c1x2", "name": "Webflow", "domain": "yourcompany.com" },
"received_at": "2026-11-20T09:30:00.000Z",
"data": {
"name": "Jane Cooper",
"email": "jane@example.com",
"service": "website",
"budget": "25k_50k"
},
"values": {
"name": "Jane Cooper",
"email": "jane@example.com",
"service": "Website",
"budget": "$25k to $50k",
"ai_summary": "Jane from Acme wants a new website and has a budget of $25k to $50k."
}
}dataholds the answers exactly as they were sent: option values, numbers as text, lists as arrays.valuesholds every answer as people read it, plus the values your flow created with Set values and Ask AI.sourceisnullfor test submissions from the form builder.
Headers
| Header | Value |
|---|---|
Content-Type | application/json |
User-Agent | Formera/1.0 |
X-Formera-Event | submission.created |
X-Formera-Delivery | A unique id for this delivery: the run id and the step id. |
Idempotency-Key | The same as the delivery id. A delivery sent again by Run flows again has a new id. |
X-Formera-Signature | t=<unix seconds>,v1=<hex HMAC SHA-256>, when the webhook has a signing secret. |
Check the signature
Each webhook destination has its own signing secret. Owners and admins see it when they edit the webhook on the Destinations page. The signature is an HMAC SHA-256 of the timestamp, a dot, and the raw body. Compare it in constant time and reject timestamps older than five minutes.
Node.js
import crypto from "node:crypto"
// rawBody is the request body exactly as it arrived, before JSON parsing
export function verifyFormera(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map(part => part.split("=")))
const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest("hex")
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300
return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 ?? ""))
}Python
import hashlib, hmac, time
def verify_formera(raw_body: bytes, header: str, secret: str) -> bool:
parts = dict(part.split("=", 1) for part in header.split(","))
signed = f"{parts['t']}.".encode() + raw_body
expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
fresh = abs(time.time() - int(parts["t"])) < 300
return fresh and hmac.compare_digest(expected, parts.get("v1", ""))Answering
- Answer with any 2xx status within 10 seconds. Anything else, or no answer, marks the step as failed and shows the status and the start of your answer in the inbox.
- Redirects are not followed, so give the final address.
- Failed deliveries are not retried on their own yet. Fix the cause, then choose Run flows again on the submission.