How to Configure Wordpress Contact Form 7 and CF7 Webhooks for Basin

Here's a quick guide that shows you how to forward your Contact Form 7 submissions to Basin using the CF7 Webhooks plugin.

Contact Form 7 is a simple form builder for WordPress that makes it easy to setup and manage forms on your WordPress site. It does not come with persistent submissions storage, advanced spam features, email configurations, or many of the other Basin features. This is why it might make sense to use Basin. 

Getting Started

 
Before we get too far, let's make sure we have everything we need to make this work:
 
1. Install Contact Form 7
2. Install CF7 Webhooks
3. A Basin account

Once you've created your first form with Contact Form 7, you can navigate to the webhooks configuration tab by going Contact -> Contact Forms -> Click on the Form -> Webhook tab. Next, Go to your Basin dashboard and find your unique form endpoint.



Enter your form endpoint into the Webhook URL field.



The next step is the trickiest. 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.

Next, we will need to go to our Basin dashboard and find our Form's API Key. We recommend using your form specific API key which limits the scope of API access to only this form. Your account wide API will also work but is not recommended. You can find you Form API key under the integrations tab Form -> Integrations -> Form API Key.



A Basin API Key is needed for the next step. You'll need to add headers to your webhook to forward the IP address of the form submission you've recieved. Basically you're saying this is the original IP and this is my key to authorize this submission. Copy and paste the following block and replace the API key with your own.

Basin-API-KEY: [YOUR_BASIN_API_KEY]
Basin-True-Client-IP: [_remote_ip]
Origin: [_url]
Referer: [_url]
User Agent: [_user_agent]


And that's it! You are ready to start forwarding all your submissions to Basin. You can now enjoy secure submission storage, beautiful email templates, easy spam filtering, and many more great features.
 
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. 

Also let's make sure to reconize this wouldn't be possible without open source maintainers like Mário Valney! Big thanks to him for maintaining CF7 to Webhook and making this all possible. 🙏

Next Steps

I recommend setting up lead agent to pre-process, score, and tag your leads!

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