Skip to content

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."
  }
}
  • data holds the answers exactly as they were sent: option values, numbers as text, lists as arrays.
  • values holds every answer as people read it, plus the values your flow created with Set values and Ask AI.
  • source is null for test submissions from the form builder.

Headers

HeaderValue
Content-Typeapplication/json
User-AgentFormera/1.0
X-Formera-Eventsubmission.created
X-Formera-DeliveryA unique id for this delivery: the run id and the step id.
Idempotency-KeyThe same as the delivery id. A delivery sent again by Run flows again has a new id.
X-Formera-Signaturet=<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.
Made with Modulify