What is Server Post Integration?
Server Post integration sends results from your form as a POST, or webhook, to a third-party server.
Requirements
The Server Post integration feature requires a Professional level 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.
Message Formats
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:
ID - Checkbox/Radio items:
ID - Text Matrix items:
ID-column-row - Checkbox/Radio Matrix:
ID-row - Checkbox/Radio Multi-scale:
ID-scale-row
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.
The easiest way to see how your message data will look is by integrating with a POST testing service like RequestBin or httpbin.
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 301 or 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.
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.