Below are instructions on how you can setup your forms so that submissions get posted to another system or API endpoint automatically on form submit.
- Go to your "My Forms" screen and click on the edit icon of the form you wish to get form submissions data from. The icon looks like this:
- Now that you are in the form editor, go to the “Destination” settings module placed at the right menu. It looks like this:
- When you click on this module it will show a popup with this option:
- To send form submissions data to a 3rd Party web service, tick "3rd Party URL", then enter the URL of the web-service which should be sent the form submissions data on each submission of the form. (Note: you can still keep the other options ticked so that form submissions still go to the GlobalPatron database, or an E-mail address at the same time)
- Click on “Save Changes"
- From then onwards, any form submissions will also post the collected JSON data to the URL you have specified above.
Technical Details
- The form submission data will be sent as a HTTPS POST in JSON format, with the following structure:
{
"form_id": "xxxxxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"form_fields":
[
{
"unique_system_name": "gp_form_field_xxxxxxxxxxxxx",
"submitted_value": "[FIELD VALUE HERE]"
},
{
"unique_system_name": "gp_form_field_xxxxxxxxxxxxx",
"submitted_value": "[FIELD VALUE HERE]"
},
{
"unique_system_name": "gp_form_field_xxxxxxxxxxxxx",
"submitted_value": "[FIELD VALUE HERE]"
}
]
} - To avoid the scenario of someone finding out your webhook URL and spamming it, it is recommended to pass a unique key in the header value with the post (or as a querystring parameter) for your system to be able to authorise the post as having come via GlobalPatron
Zapier Users
If you are a Zapier user please view this article which includes detailed Zapier Integration Instructions
Once the data is posted to a Zapier "Raw Catch WebHook" you can basically send on the data to almost ANYTHING, for example you can send the form submission data to:
- Google Sheets (https://zapier.com/apps/google-sheets/integrations/webhook/1035/add-info-to-a-google-sheet-from-new-webhook-post-requests)
- Drip Campaigns (https://zapier.com/apps/drip/integrations/webhook/6735/create-or-update-drip-subscribers-via-webhooks)
- Slack messages (https://zapier.com/apps/slack/integrations/webhook)