Webhooks Pro

Send form submission data to external services via HTTP POST requests. Connect with Zapier, Make, n8n, and more.

What Are Webhooks?

A webhook sends a JSON payload to a URL of your choice every time a form is submitted. This lets you integrate Giraforms with hundreds of external services without writing code.

Creating a Webhook

Open Webhook Settings

Go to Forms → Integrations and click Manage Webhooks, then click Add Webhook.

Configure the Webhook

Setting	Description
Name	A label to identify this webhook (e.g., "Zapier CRM")
URL	The endpoint URL to send data to
Form	Which form triggers this webhook (or "All Forms")
Secret	Optional secret key sent as `X-Giraforms-Secret` header for verification
Status	Active or inactive

Save & Test

Save the webhook, then use the Send Test button to send a sample payload to your URL and verify it's received correctly.

JSON Payload

When a form is submitted, Giraforms sends a POST request with this JSON structure:

{
  "event": "form_submission",
  "submission_id": 1337,
  "form_id": "form_abc123",
  "form_name": "Contact Form",
  "submitted_at": "2025-03-15T14:30:00+00:00",
  "data": {
    "Full Name": "Jane Doe",
    "Email Address": "jane@example.com",
    "Message": "Hello, I'd like to learn more about your services."
  },
  "fields": [
    { "name": "text_field_1", "label": "Full Name", "type": "text" },
    { "name": "email_field_1", "label": "Email Address", "type": "email" },
    { "name": "textarea_field_1", "label": "Message", "type": "textarea" }
  ]
}

The data object contains field labels as keys with their submitted values. The fields array provides metadata about each field (internal name, label, and type).

Giraforms sends the following HTTP headers with each webhook request:

Content-Type: application/json
User-Agent: Giraforms/{version}
X-Giraforms-Secret: {your_secret} — included if a secret key is configured for the webhook

Webhook creation form with Name, URL, Form selector, Secret key, and Active toggle

Managing Webhooks

The webhooks list (accessible via Forms → Integrations → Manage Webhooks) shows all configured webhooks with actions:

Edit — modify the URL, form assignment, or name
Activate / Deactivate — toggle the webhook on or off without deleting it
Send Test — send a sample payload to verify connectivity
Delete — permanently remove the webhook

Integration Examples

Zapier

Connect with Zapier

Create a new Zap in Zapier
Choose Webhooks by Zapier as the trigger
Select Catch Hook
Copy the webhook URL Zapier provides
Paste it into Giraforms webhook URL field
Use Send Test to send sample data
In Zapier, test the trigger to confirm data is received
Add actions (e.g., create a Google Sheet row, send a Slack message)

Make (formerly Integromat)

Connect with Make

Create a new scenario in Make
Add a Webhooks → Custom webhook module
Click Add to create a new webhook and copy the URL
Paste it into Giraforms and use Send Test
In Make, click Re-determine data structure
Add modules to process the data (CRM, email, database, etc.)

n8n

Connect with n8n

Create a new workflow in n8n
Add a Webhook node as the trigger
Set the HTTP method to POST
Copy the production webhook URL
Paste it into Giraforms and send a test
Add processing nodes to your workflow

Troubleshooting

Webhook not firing? Check that the webhook status is Active and assigned to the correct form. Use Send Test to rule out URL issues.

Timeout errors: The receiving server must respond within 15 seconds
SSL errors: Make sure the webhook URL uses HTTPS with a valid certificate
Authentication: Use the webhook secret key to verify requests on your server via the X-Giraforms-Secret header

Connect your forms to anything

Send form data to Zapier, Make, n8n, or any URL with webhooks. Available with Giraforms Pro.

Get Giraforms Pro