What is Server Post Integration?
Server Post integration sends results from your form as a POST, or webhook, to a third-party server.
The Server Post integration feature requires a Pro 1 level or higher Formsite account.
The receiving server needs an application or API that can accept one of our message formats. If you're integrating with an existing system, its possible it requires a specific format or method we don't support.
Create a New Integration
On your form's "Integrations" page, click the integration for "Server Post". Then, enter your server's full URL (beginning with "http" or "https") and its supported message format. When you're finished, click the "Save" button.
The "name-value pairs" format sends data in "form" format. If you're looking to make a standard webhook or aren't sure which format to use, this is probably the right format. The other formats (JSON and XML) send data in the HTTP request body. All message formats use UTF-8 encoding.
In the message content, items are identified by ID. These are the same IDs used by our API and can be seen on your form's "Integrations -> API" page. Item IDs use these formats:
- Text items:
- Checkbox/Radio items:
- Text Matrix items:
- Checkbox/Radio Matrix:
- Checkbox/Radio Multi-scale:
You can use Results Labels to replace the IDs with your own labels. For example, to replace the IDs with the parameter names expected by your server. If your server requires extra parameters that don't correspond to items, you can use the "Additional parameters" setting to add them.
Collecting Server Post Results
When a form user completes your form, their result will be posted to your server. Your server's HTTP response code will determine the integration's status: any
200 range code will be considered a success, a
302 code will be followed and retried, and any other code will be considered a failure and trigger an error page.
If you've enabled the "Use server response as Success Page" setting, your form will use the content returned by your server as a Success Page. This will override any other Success Pages you've set up, unless your form is an order form.
When you edit a result on your form's "Results" page, it will be resent to your server.
Note: This option is no longer available for new forms. To automatically delete old results, use the Data Retention feature.
The "purge my results" option will delete each new result immediately after it's been posted. This bypasses your account's storage limits, but has several important drawbacks:
- Features that show results won't be able to show deleted results, such as: Notifications with password links, Reports, Success Pages with receipt links, etc.
- File links and Signature links in Notifications and posted data won't work. By the time you visit the links the data will have already been deleted.
- Any data you don't process on your server will be lost.
Important: If there's any unexpected trouble during the post, such a network problem or application bug, the result may still get deleted. We strongly recommend you do not purge results so they remain in your form as a backup.
Tips and Troubleshooting
If your server is returning an error, try using the "Use server response as Success Page" setting to see if there is an error page with more information. If you have direct access to your server, your server logs are the best source of information.