Webhooks
Formgong POSTs JSON and an HMAC-SHA256 signature of the raw body. The secret is in the form settings. Up to 5 attempts; retries wait 30s, 2m, 10m, and 30m.
If the last attempt still fails, Formgong emails the form owner. The same email is sent when a Slack or Discord webhook, any other webhook, Google Sheets, or Telegram fails after those retries. You get at most one email a day for each form and channel, on every plan, including Free. A Telegram email says what went wrong in plain words (for example the bot was removed from the group, the chat was not found, or the user blocked the bot) and how to reconnect: create a new code in the form settings, open the bot link, or add the bot to the group and send /connect with that code.
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "Emma", "email": "emma@example.com" },
"is_spam": false
}
}
Header X-Signature: sha256=…. Header X-Formgong-Event: submission.created.
import { createHmac, timingSafeEqual } from "node:crypto";
function verified(rawBody, signature, secret) {
const digest = createHmac("sha256", secret).update(rawBody).digest();
const got = Buffer.from(String(signature).replace(/^sha256=/, ""), "hex");
return got.length === digest.length && timingSafeEqual(got, digest);
}
File links in webhooks
Each uploaded file in the webhook gets a signed download_url that opens without signing in until it expires. Anyone who has the link can download the file, so turn this on only if the service that receives your webhook needs the files. Turning it off, rotating the webhook secret or deleting the submission stops the links at once.
To turn it on, open the form's settings, accept file attachments, then go to the webhook section, choose 24 hours or 7 days under “File links in webhooks” and save. Only webhooks sent after that carry the links.
"attachments": [{
"id": "…", "field": "photo", "filename": "cart.jpg", "size": 182044, "content_type": "image/jpeg",
"url": "https://formgong.com/dashboard/forms/…/attachments/…",
"download_url": "https://formgong.com/files/…?exp=…&sig=…",
"download_expires_at": "2026-11-02T12:00:00.000Z"
}]
Each file in submission.attachments then also has download_url and download_expires_at. The receiving service downloads the file with a plain GET request: no headers, no login. After the expiry time the link returns 404, and one file can be downloaded up to 60 times an hour. Emails, Telegram and Slack or Discord messages never get these links.
Slack and Discord
Paste a Slack incoming-webhook URL (https://hooks.slack.com/services/…) or a Discord channel webhook URL (https://discord.com/api/webhooks/…) into the webhook field. Formgong then sends a short chat message with the form name, the answers, the page and a link to the submission instead of the JSON above.
Mentions such as @everyone, @here and @channel are defused, a visitor cannot hide a link behind other text, and long submissions are cut to the platform limits with a link to the full submission. Files are listed by name. The X-Signature header is still sent, retries and delivery logs work as for any webhook, and “Send test” shows what the message looks like.
Slack workflow links (hooks.slack.com/triggers/…) and every other URL get the JSON payload.
Make, n8n, Zapier
Create a webhook module (Make), a Webhook node (n8n), or a Catch Hook (Zapier) and paste that URL into the form settings. Map submission.fields from there.
Step-by-step recipes: Make, n8n, Zapier, KeyCRM.
Google Sheets
// Webhook URL: the web app URL + "?key=" + the same SECRET (Apps Script cannot read headers).
const SECRET = "change-me";
function doPost(e) {
if (e.parameter.key !== SECRET) return reply();
const body = JSON.parse(e.postData.contents);
if (body.event !== "submission.created") return reply(); // the dashboard test sends "webhook.test"
const lock = LockService.getScriptLock();
lock.waitLock(20000);
try {
const sheet = SpreadsheetApp.getActive().getSheetByName("Leads");
const id = body.submission.id;
// A retry after a timeout carries the same id: skip rows that are already there.
if (!sheet.getRange("A:A").createTextFinder(id).matchEntireCell(true).findNext()) {
const fields = body.submission.fields;
sheet.appendRow([id, body.submission.created_at, fields.name, fields.email, fields.message]);
}
} finally {
lock.releaseLock();
}
return reply();
}
// HtmlService, not ContentService: ContentService answers with a redirect, and a webhook counts a redirect as a failure.
function reply() {
return HtmlService.createHtmlOutput("ok");
}
HTML form to Google Sheets: 2 free methods →
KeyCRM
There is no native connector. In n8n or Make, receive the Formgong webhook and call the KeyCRM API with your own key. Read fields from submission.fields.