Send Form Responses to Any URL

What your endpoint receives

Each request has the header Content-Type: application/json plus any custom headers you added. The body looks like this (values are illustrative):

{
  "formId": "form id",
  "formTitle": "Contact us",
  "responseId": "response id",
  "submissionId": "readable submission reference",
  "submittedAt": "2026-09-17T10:30:00.000Z",
  "responses": {
    "<question id 1>": "Priya Sharma",
    "<question id 2>": "[email protected]",
    "<question id 3>": "I would like a callback"
  },
  "metadata": {
    "userAgent": "Mozilla/5.0 ...",
    "ipAddress": "203.0.113.10",
    "referrer": "https://example.com/contact",
    "utm": { "utm_source": "google", "utm_campaign": "diwali" },
    "embedOrigin": "https://example.com"
  }
}

• responses holds only the questions that were answered, keyed by question ID. Map the IDs to your own field names once, after you submit a real test response.
• utm and embedOrigin are included only when that source information was recorded for the response, for example when the form was opened from an embed or a link with UTM tags.
• The body includes the respondent's IP address, so treat stored requests as personal data.

A minimal receiver

This Node.js (Express) example checks a secret header, saves the lead and replies with 200 straight away:

import express from "express";

const app = express();
app.use(express.json());

app.post("/hooks/edesy-forms", (req, res) => {
  if (req.get("X-Api-Key") !== process.env.FORMS_WEBHOOK_KEY) {
    return res.sendStatus(401);
  }

  const { formTitle, responseId, submittedAt, responses, metadata } = req.body;

  // Reply first; anything outside 2xx is logged as a failed delivery.
  res.sendStatus(200);

  saveLead({ formTitle, responseId, submittedAt, responses, source: metadata?.utm });
});

app.listen(3000);

In the webhook settings, add the header as JSON: {"X-Api-Key": "your-long-random-secret"}.

To see the exact body before writing any code, point the webhook at a request inspector such as webhook.site, then submit your form once.