Receive Jotform submissions

Guides

Jotform does not sign its webhooks, so the webhook uses an unsigned URL: a long random token in the URL is the credential. Receive a webhook from any system covers the shared settings.

Set up

1. In Manage Account > Webhooks, select New webhook, enter a name, set Signature to Jotform (unsigned) and press Create webhook.
2. Copy the Webhook URL. It is shown once.
3. In Jotform, open the form, select Settings, then Integrations.
4. Search for Webhooks and select it.
5. Paste the webhook URL into Add WebHook.
6. Select Complete Integration, then Finish.

Treat the URL like a password

Anyone with the URL can start a run. Press Rotate to get a new URL; the old one keeps working for 24 hours, or until you press Revoke old secret.

What arrives

Jotform sends the answers as JSON inside a form field named rawRequest. DataLug lifts the answers into the row beside Jotform's own fields, so a submission is one row such as:

{
  "q3_name": { "first": "Test", "last": "Lead" },
  "q4_email": "lead@example.com",
  "q6_message": "Hello",
  "formID": "253010000000001",
  "submissionID": "6100000000000000001"
}

The answer keys follow the field names in your form. Values from the form fields are text.

Duplicates

When the request carries a submissionID field, it is the event id: a submission that arrives twice runs once. A request without it is a duplicate only when its body repeats within 24 hours.

Responses

An accepted submission is answered 200. A wrong or missing token is answered 404, the same as an unknown webhook, and is not recorded. File uploads in the request are refused with 400.