How do I connect HelloForms to Custom webhook?

Paste the https URL that should receive submissions. Verify the X-HelloForms-Signature header using the signing secret shown after you save. You can do the whole thing from the form's Integrations tab — no code and no developer account required.

What do I need before I start?

You need a Custom webhook webhook URL. Everything else is configured in HelloForms.

What does Custom webhook receive for each submission?

Signed JSON: form metadata, question labels, answers, submission id and timestamps. You choose which questions are included, so fields you would rather keep private never leave HelloForms.

Is the Custom webhook integration available on the free plan?

Yes. Delivery destinations are part of the product rather than a paid add-on, so you can connect and test one on a free form before upgrading.

What happens if a delivery to Custom webhook fails?

Transient failures are retried automatically with exponential backoff, and every attempt is written to the delivery log with the status code and the response body the provider returned. Repeated hard failures disable the destination instead of retrying forever, and you can retry a specific submission from the response.

Where are my credentials stored?

Webhook URLs are stored server-side, are never rendered in your published form, and are shown masked in the dashboard. Delivery happens from the server, so nothing is exposed to respondents.

Can I reuse the same Custom webhook connection on other forms?

Yes. Save it as an account-level connection once and pick it from the credentials selector when you add the destination to another form — you never re-enter the token.

Is the Custom webhook payload signed?

Yes. The request body is the HelloForms signed envelope, and the X-HelloForms-Signature header lets your endpoint verify the payload before trusting it.

How do I verify the request really came from HelloForms?

Every request carries an X-HelloForms-Signature header. Recompute the HMAC over the raw request body with your signing secret and compare in constant time.

Webhooks integration

Send form responses to your own webhook

Paste any https endpoint you control and each submission is POSTed as a signed JSON envelope. Verify the X-HelloForms-Signature header with the secret shown after saving, and do whatever your backend needs.

Build a form free Browse templates

What the Custom webhook integration does

HMAC signature header so your endpoint can reject anything it did not expect.
Retries with exponential backoff, and repeated failures disable the destination instead of hammering it.
Every attempt — status, response and duration — is visible in the delivery log.

What it looks like

Signed JSON: form metadata, question labels, answers, submission id and timestamps.

HelloForms — response

Removals enquiry · #4821

Full name: Priya Raman
Email: priya@northgate.co
Service needed: Office move
Budget: £2,000 – £5,000

Custom webhook — request received

POST /hooks/forms · 200 OK · 148 ms

X-HelloForms-Signature: sha256=…

{
  "submission_id": "4821",
  "form": "Removals enquiry",
  "answers": {
    "Full name": "Priya Raman",
    "Email": "priya@northgate.co",
    "Service needed": "Office move"
  }
}

Demo data: a HelloForms response on the left, and how it arrives in Custom webhook on the right.

How to connect Custom webhook to your form

1
Paste the https URL that should receive submissions.
2
Verify the X-HelloForms-Signature header using the signing secret shown after you save.

Configuration template and sample payload

Download a filled-in checklist of every value the Custom webhook destination asks for, plus an example of exactly what Custom webhook receives for one submission — useful for planning a mapping or handing the setup to a developer.

Every field the "Add integration" dialog asks for, with placeholders to fill in. Keep it as documentation of your Custom webhook mapping — do not commit a completed copy to a public repository.

{
  "$schema": "https://helloforms.net/integrations/config-template.schema.json",
  "helloforms": {
    "destination": "generic",
    "label": "Custom webhook",
    "docs": "https://helloforms.net/integrations/webhook"
  },
  "enabled": true,
  "events": [
    "submission.created"
  ],
  "url": "https://example.com/your-endpoint",
  "includedQuestions": [
    "Full name",
    "Email",
    "How can we help?"
  ],
  "notes": [
    "Never commit a filled-in copy of this file to a public repository.",
    "Values are entered in HelloForms → your form → Integrations; this file is a checklist and a record of your mapping.",
    "Verify the X-HelloForms-Signature header before trusting a request."
  ]
}

Custom webhook integration FAQs

Who uses it

Developers writing submissions straight into their own database.
Products that need a custom enrichment or validation step on receipt.
Anything not covered by a ready-made destination.

Zapier
Sends flat, Zap-friendly JSON to a Catch Hook trigger.
Zapier integration
n8n
Sends the signed envelope to an n8n Webhook node.
n8n integration
Slack
Posts a formatted submission card into a Slack channel.
Slack integration

Build a form that feeds Custom webhook today

Every destination is included on every plan — no per-integration add-ons.

Start building See all integrations