Webhooks in Formnex

Webhooks allow you to receive real-time data from Formnex when a form is submitted. This means that every time someone submits a form on your website, Formnex can instantly send the data to your own server or a third-party service by making an HTTP POST request to your configured webhook URL.

Getting Started with Webhooks

Setting up a webhook in Formnex is simple and requires just a few steps:

Step 1: Go to Your Endpoint

• Navigate to the Endpoints section in your Formnex Dashboard and select the endpoint you want to attach a webhook to.

Step 2: Add a Webhook URL

• You'll find a section labeled Webhook URL. Paste in your server's URL or any third-party URL where you'd like to receive the form submission data.

Example:

https://example.com/api/form-handler

🔐 Make sure your endpoint is secured and set up to receive POST requests with a JSON body.

Payload Structure

Formnex sends the form submission data as JSON in the body of the request. Here’s a sample payload:

{
  "endpoint": "contact-form",
  "type": "success",
  "submittedAt": "2025-05-16T10:24:00Z",
  "data": {
    "name": "Jane Doe",
    "email": "jane@example.com",
    "message": "Hello, I'm interested in your services."
  }
}

You can use this payload to:

• Store form data in your own database
• Trigger email notifications
• Log submissions in third-party tools
• Send responses to Slack, Discord, or other apps

Use Cases

Here are some common ways developers use Formnex webhooks:

• ✉️ Send automatic email notifications
• 📁 Log submissions to internal dashboards or CRMs
• 📈 Store responses for analytics
• ⚙️ Trigger custom business workflows

Best Practices

• Ensure your webhook endpoint is protected and only accepts trusted data
• Validate the structure of the incoming request body
• Respond quickly with a 200 OK status to acknowledge the webhook
• Log failed webhook deliveries for debugging

Testing Your Webhook

Use tools like:

• Webhook.site
• RequestBin
• Ngrok (for local testing)

These tools allow you to preview the payload Formnex sends when your form is submitted.

Notes

• You can add different webhooks to different endpoints.
• Webhooks only trigger on successful submissions.
• Retry policies and headers will be available in advanced options.Coming Soon

💡 Tip: Want to troubleshoot failed submissions? Be sure to visit the Submission Logs in your dashboard.