Webhooks

What are webhooks?

Webhooks allow you to send form submission data to any URL endpoint automatically. When someone submits your form, SmarterForm will make an HTTP POST request to your specified URL with the submission data.

Setting up webhooks

1. 1

   Open your form settings

   In the Form Builder, click the Settings tab in the left sidebar.

2. 2

   Navigate to Integrations

   Scroll down to the Integrations section and click Webhooks.

3. 3

   Add your webhook URL

   Enter the URL where you want to receive submission data. This should be a publicly accessible endpoint that can accept POST requests.

4. 4

   Test your webhook

   Click Test Webhook to send a sample payload to your endpoint and verify it's working correctly.

Webhook payload

When a form is submitted, SmarterForm sends a POST request with the following JSON structure:

{
  "formId": "abc123",
  "formName": "Contact Form",
  "submissionId": "sub_xyz789",
  "submittedAt": "2024-01-15T10:30:00Z",
  "responses": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello, I'd like to learn more..."
  }
}

Security best practices

• Verify the source: Check the request origin to ensure it's coming from SmarterForm.
• Use HTTPS: Always use HTTPS endpoints to encrypt data in transit.
• Validate data: Validate and sanitize all incoming data before processing.
• Handle errors: Implement proper error handling for failed webhook deliveries.

Troubleshooting

Webhook not firing

If your webhook isn't receiving data:

• Verify your endpoint URL is correct and publicly accessible
• Check that your server is accepting POST requests
• Review your server logs for incoming requests
• Test with the built-in webhook tester