How to Forward Gravity Forms Submissions to Basin with Webhooks
Anthony Penner on Jul 8 2022
This is a quick guide that shows you how to forward your WordPress Gravity Forms submissions to Basin. Basin provides many features out of the box and saves you from the configuration headaches usually associated with WordPress.
Getting Started
We will need a few things in order for all of this to work. Before we proceed, make sure:
1. The Gravity Forms plugin is installed with the Elite License plan. Learn more about installing Gravity Forms here.
2. The Gravity Forms Webhooks Add-On. (We will show you how to add this)
3. A Basin account.
Assuming you have the Gravity Forms plugin installed already, we are ready to go. First, install the Gravity Forms Webhook Add-On by clicking on Forms -> Add-Ons. Then scroll down to Webhooks Add-On and click Activate.
Next, we need to go to the form we would like to forward the submissions to Basin and select Settings -> Webhooks. This will take us to the Webhooks configuration page.
Click Add New.
In order to configure our Gravity Forms webhook, we will need our unique Basin form endpoint and our Account API Key.
The Account API key can be found under the avatar dropdown menu at the top right of the basin dashboard under My Account -> Basin API.
We will plug the two values we found from the Basin dashboard into our Webhook settings as shown below. We need to preserve the submitting user's IP address so our spam filters do not think submissions are originating from a shared hosting provider or web server. This is a common source of spam abuse for us and an important way of detecting legitimate submissions.
In the next step, you will need to add a couple of custom headers. From the Name dropdown, select Add Custom Key. User IP, Origin, and Source Url should all be found in the dropdown as pre-selectable items. Origin is required in order for your "allowed domains" as configured on your Basin project does not mark these webhooks as spam either.
Make sure the headers are named Basin-API-Key and Basin-True-Client-IP. Once that's configured, you're form is ready to go!
And that's all there is to it. You're ready to start forwarding all your submissions to Basin. You can now take advantage of easy spam filtering, secure submission storage, beautiful email templates and branding, and much more.
If you need help with configuring this on your WordPress site, be sure to reach out to our support and we would love to help you out.
Extra docs:
Depending on your server setup, more configuration may be required to pass the user's real IP address to Basin. Read the Gravity Forms docs about IP addresses.
1. The Gravity Forms plugin is installed with the Elite License plan. Learn more about installing Gravity Forms here.
2. The Gravity Forms Webhooks Add-On. (We will show you how to add this)
3. A Basin account.
Assuming you have the Gravity Forms plugin installed already, we are ready to go. First, install the Gravity Forms Webhook Add-On by clicking on Forms -> Add-Ons. Then scroll down to Webhooks Add-On and click Activate.
Next, we need to go to the form we would like to forward the submissions to Basin and select Settings -> Webhooks. This will take us to the Webhooks configuration page.
Click Add New.
In order to configure our Gravity Forms webhook, we will need our unique Basin form endpoint and our Account API Key.
The Account API key can be found under the avatar dropdown menu at the top right of the basin dashboard under My Account -> Basin API.
We will plug the two values we found from the Basin dashboard into our Webhook settings as shown below. We need to preserve the submitting user's IP address so our spam filters do not think submissions are originating from a shared hosting provider or web server. This is a common source of spam abuse for us and an important way of detecting legitimate submissions.
In the next step, you will need to add a couple of custom headers. From the Name dropdown, select Add Custom Key. User IP, Origin, and Source Url should all be found in the dropdown as pre-selectable items. Origin is required in order for your "allowed domains" as configured on your Basin project does not mark these webhooks as spam either.
Make sure the headers are named Basin-API-Key and Basin-True-Client-IP. Once that's configured, you're form is ready to go!
And that's all there is to it. You're ready to start forwarding all your submissions to Basin. You can now take advantage of easy spam filtering, secure submission storage, beautiful email templates and branding, and much more.
If you need help with configuring this on your WordPress site, be sure to reach out to our support and we would love to help you out.
Extra docs:
Depending on your server setup, more configuration may be required to pass the user's real IP address to Basin. Read the Gravity Forms docs about IP addresses.
Get Started with a Free Basin account today!
Discover the benefits of Basin and how it can help streamline your forms. Sign up now and explore our features.
Sign Up for Free