Webhooks

Webhooks let you trigger external workflows every time a form submission arrives. Send data to Zapier, Make, your own API, a Slack channel, or anything that can receive an HTTP POST.

Setting up a webhook

1. Open your form in the dashboard 
2. Go to Form Settings → Webhooks
3. Click Add endpoint
4. Enter your endpoint URL
5. Save

Formtorch will send a POST request to that URL for every new submission.

Payload

The request body is JSON with the following shape:

{
  "formId": "a1b2c3d4e5",
  "submissionId": "x9y8z7w6v5",
  "fields": {
    "name": "Alex",
    "email": "alex@example.com",
    "message": "Hello there"
  },
  "submittedAt": "2025-03-15T14:30:00.000Z",
  "isSpam": false,
  "spamScore": 0
}

The fields object contains all the submitted form data except reserved _* fields.

Signature verification

Every webhook request includes an X-Formtorch-Signature header. This is an HMAC-SHA256 signature of the raw request body, signed with your webhook secret.

Verify it on your server to confirm the request came from Formtorch:

import { createHmac } from "crypto";
 
export async function POST(req: Request) {
  const body = await req.text();
  const signature = req.headers.get("x-formtorch-signature") ?? "";
 
  const expected = createHmac("sha256", process.env.WEBHOOK_SECRET!)
    .update(body)
    .digest("hex");
 
  if (signature !== `sha256=${expected}`) {
    return new Response("Unauthorized", { status: 401 });
  }
 
  const data = JSON.parse(body);
  // process data...
 
  return new Response("OK");
}

Your webhook secret is shown in the dashboard when you create the endpoint.

Retry behavior

If your endpoint returns a non-2xx status code or times out, Formtorch retries the delivery with exponential backoff:

After 3 failed retries, the delivery is marked as failed. You can see delivery status for each submission in the dashboard.

What triggers a webhook

Webhooks fire for every non-spam submission. They do not fire for:

• Spam submissions (isSpam: true)
• Test submissions (_test=true)

Webhooks are available on Starter and Pro plans. See the pricing page  for a full plan comparison.