Enter app

Send an outbound webhook

A per-form side channel: an HMAC-signed POST to your own web address for every accepted submission, alongside the form's normal output.

Pro and above

Open the connection's Setup, open Advanced, enter a web address under Outbound webhook, and select Generate secret. The secret is shown once; copy it before leaving the panel. No secret, no webhook — nothing is sent until one is generated.

What is sent

One POST request per accepted submission, delivered in the same pass as the form's own output, and retried the same way as other alerts.

Body
{
  "event": "submission.accepted",
  "deliveryId": "…",
  "submissionId": "…",
  "formId": "…",
  "workflow": "…",
  "receivedAt": "2026-09-25T00:00:00.000Z",
  "record": { "<field>": "<value>" },
  "files": [ { "field": "…", "name": "…", "bytes": 0 } ]
}
HeaderValue
Content-Typeapplication/json
X-Webtzm-DeliveryThis delivery's id
X-Webtzm-TimestampUnix seconds, the moment the request was signed
X-Webtzm-Signaturesha256=<hex HMAC-SHA256 over "timestamp.body">
User-AgentWebtzm-Webhook/1

Send a test event

Once an address is saved and a secret generated, Send test event in the same place sends one signed request to the saved address, so you can see how your endpoint answers before a visitor's submission finds out. It is signed and timed out exactly like a real delivery, and Webtzm tells you only what came back: the status your endpoint answered with, or that it did not answer within ten seconds. Five test events a minute are allowed for each form.

Test body
{
  "event": "webhook.test",
  "deliveryId": "whd_test_…",
  "formId": "…",
  "workflow": "…",
  "sentAt": "2026-09-25T00:00:00.000Z"
}

A test event has no record and no submissionId, and a test is never retried. Check event and return a 2xx for it without storing anything.

Verify the signature

Recompute the signature from the raw request body and the timestamp header, using the secret shown when it was generated. Compare in constant time; do not use === on the two strings.

Node
import { createHmac, timingSafeEqual } from "node:crypto";

function isValidWebhook(secret, timestampHeader, rawBody, signatureHeader) {
  const expected = createHmac("sha256", secret)
    .update(`${timestampHeader}.${rawBody}`)
    .digest("hex");
  const expectedBuffer = Buffer.from(`sha256=${expected}`);
  const providedBuffer = Buffer.from(signatureHeader || "");
  return expectedBuffer.length === providedBuffer.length
    && timingSafeEqual(expectedBuffer, providedBuffer);
}

Retries

A ten-second timeout applies to every attempt. Any 2xx response is success. Anything else, including a timeout, retries on the same schedule as the form's other delivery alerts: four attempts in all, about 2, 4 and 8 minutes apart. After the fourth the entry shows Needs review, and Send again tries once more.

Revoking

Selecting Revoke in the console deletes the stored secret immediately. No further webhook is sent until a new secret is generated.

Something missing or wrong on this page? Tell support.