Step by Step Guide
Easily integrate Comfyform into your service ecosystem. To use webhooks for connecting your forms to your server or another service, follow these steps:- Access your Comfyform dashboard.
- Navigate to the Forms section and select the form you want to enable webhooks on.
- Click on the Notifications tab.
- Locate the Webhooks option and click “Activate”. To adjust an existing webhook, click “Modify”.
- Provide the URL of the server endpoint that will receive the webhook POST request.
- Save the changes to initiate the webhook functionality.
JSON Data Structure
Upon form submission, Comfyform will dispatch a POST request to the defined URL, delivering JSON data such as:Automated Retries
If Comfyform’s initial webhook POST request doesn’t receive a status code within the 2XX success status codes range (e.g., 200 OK, 201 Created, 202 Accepted, etc.) from your endpoint, the system will retry automatically according to the following schedule:Attempt | Time from the submission processing |
---|---|
1 | immediately |
2 | 5 seconds |
3 | 15 seconds |
4 | 1 minute |
5 | 5 minutes |
6 | 15 minutes |
7 | 30 minutes |
8 | 1 hour |
9 | 3 hours |
10 | 8 hours |
11 | 16 hours |
12 | 1 day |
13 | 2 days |
14 | 4 days |
15 | 7 days |
Best Practices
- Secure Your Endpoint: Use HTTPS to ensure all data transferred via webhooks is encrypted.
- Verify Requests: Add a unique verification token as a query parameter in your webhook URL and validate it server-side to authenticate incoming requests.
- Manage Load: Prepare your server to efficiently handle potential surges in POST requests following multiple form submissions.
- Error Handling: Develop robust error handling to manage webhook failures or irregularities gracefully.