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.
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.
{
"event": "submission.accepted",
"deliveryId": "…",
"submissionId": "…",
"formId": "…",
"workflow": "…",
"receivedAt": "2026-09-25T00:00:00.000Z",
"record": { "<field>": "<value>" },
"files": [ { "field": "…", "name": "…", "bytes": 0 } ]
}
| Header | Value |
|---|---|
Content-Type | application/json |
X-Webtzm-Delivery | This delivery's id |
X-Webtzm-Timestamp | Unix seconds, the moment the request was signed |
X-Webtzm-Signature | sha256=<hex HMAC-SHA256 over "timestamp.body"> |
User-Agent | Webtzm-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.
{
"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.
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.
Selecting Revoke in the console deletes the stored secret immediately. No further webhook is sent until a new secret is generated.