
Refreshed and republished on June 23, 2020
This post was originally published on March 3, 2016 and has been revamped and updated for accuracy and comprehensiveness.Pardot form handlers allow you to use your forms to post your data to Pardot. A Form handler is a great alternative to use instead of Pardot iFrame forms. They allow you to fully customize the look of your form and submit data to more than one database. In this tutorial, you will learn how to create a form handler from scratch.
Create a new form handler in Pardot
First you need to create a new form handler in Pardot under Marketing > Forms > Form Handlers.
Add the all the standard Pardot required information.
- Give the form handler a name
- Select a folder and add tags
- Choose your campaign
Choose your other custom settings.
- Kiosk/Data Entry Mode: Do you want the prospect to be cookied when they fill out the form?
- Enable data forwarding to the success location: Does you data need to submit to another database other than Pardot?
- Disable Visitor Activity throttling: Do you want to disable Pardot’s spam protection and generate a distinct visitor activity and auto-responder email for all form handler submissions?
- Success & Error Location: Choose an Error page and a Thank you page URL.
- Completion Actions: Add the any actions that should happen when a prospect fills out the form.
Here are the settings I have selected for this tutorial:
Add form fields
Add any fields you want to capture through your Pardot form handler.
TIP: Name the external field name the same as your prospect field name, but without the spaces, to avoid confusion in the next steps.
Optionally, you can add custom error message text under the advanced tab
Create the form HTML
Now that the form handler is created, the form HTML needs to be created to embed it on your website. In this tutorial, I will be going over basic markup. Feel free to add your own styling/structure that matches your website.
Copy the endpoint URL
Navigate to your Pardot form handler summary page and copy the endpoint URL.
Basic HTML structure
Here’s the basic structure to create a Pardot form using a Pardot form handler.
1 2 3 4 5 6 7 8 9 10 11 |
<form action="http://info.jennamolby.com/l/132321/2016-01-21/52334" method="post"> <label>First Name</label> <input type="text" name="firstname" /> <label>Last Name</label> <input type="text" name="lastname" /> <label>Email Address</label> <input type="email" name="email" /> <label>Company</label> <input type="text" name="company" /> <input type="submit" value="submit" required="required" /> </form> |
- Action: Must be the endpoint url for your Pardot form handler.
- Method: Must = POST
- Input: Add all the form fields you mapped while creating you Pardot form handler.
- Name: Must equal the external field name you specified when you created the Pardot form handler.
- Type: Specify the type (text, email, etc) to help with field validation.
Add Field Validation (Optional)
Optionally, you can add some front-end validation to your form. If you marked the fields as “required” when creating your form handler, Pardot would create some form validation to direct a user to another page. If you don’t want the prospect to leave the page, follow these instructions.
Add required=”required” to each of your required form fields. These should match what you specified in Pardot to avoid confusion.
1 2 3 4 5 6 7 8 9 10 11 |
<form action="http://info.jennamolby.com/l/132321/2016-01-21/52334" method="post"> <label>First Name</label> <input type="text" name="firstname" required="required" /> <label>Last Name</label> <input type="text" name="lastname" required="required" /> <label>Email Address</label> <input type="email" name="email" required="required" /> <label>Company</label> <input type="text" name="company" required="required" /> <input type="submit" value="submit" required="required" /> </form> |
Troubleshooting tips
Is your data not making its way into Pardot? Here are some troubleshooting tips to help you diagnose the issue.
- Try submitting the form with just email address required. If the prospect is created in Pardot without any issues, you might have a field type or a field mapping incorrect within your form handler.
- Check Enable data forwarding to the success location. Try checking or unchecking the option for “Enable data forwarding to the success location” within your Pardot form handler settings. Depending on how you are connecting your form handler to your web form, this may or may not need to be enabled.
- Double-check your field names are correct. The external field name you set within your form handler needs to be the EXACT SAME as what is in your HTML. Double-check that the HTML for your form fields is using the right name and remember, the name is different than an ID or CLASS.
- Use the HTTPS endpoint if your website is HTTPS. Using an HTTP endpoint for your form handler when your website is HTTPS will cause the browser to give security warnings. Update the form handler endpoint to HTTPS to resolve the issue.
Pardot Form Handlers + WordPress
There are many different ways to use Pardot Form Handlers with WordPress. Here are some resources to help you get started with using Pardot Form Handlers with WordPress:
- How to Integrate Gravity Forms With Pardot
- 5 Ways to Include Pardot Forms on Your WordPress Website
- How to Integrate Your Blog With Pardot: Tips, Tricks & Tools
Questions?
Send me a tweet @jennamolby, leave a comment below, or book a Peer Chat.
Hi Jenna! This article has been extremely helpful. Was wondering, do you have any info on how to integrate Pardot form handlers with Typeform’s webhook? I’ve added the endpoint of the form handler to Typeform but the data isn’t populating? Any ideas? Thanks!
Hi Shona, So happy you found it helpful! I haven’t tried to integrate Pardot form handlers with Typeform’s webhook. I’ve only done this through Zapier, sorry.
Hi Jenna,
Are you still able to use campaigns and pardot campaigns to track the success of a form handler? We’ve set up landing pages with separate form handlers and associated campaigns and child campaigns within pardot and while testing the test is not going through to the associated campaign.
Best,
Caroline
Hi Caroline, Yes, you still should be able to use campaigns along with a Pardot form handler. Maybe what you’re experiencing is the issue where visitor cookies are not being associated with the Pardot prospect?
Here’s more information on that https://help.salesforce.com/articleView?id=000322102&type=1&mode=1.
Hi Jenna – Love your site! It’s been very helpful in dealing with Pardot for issues and the like. I’ve been searching high and low and thought you might have some new insight on how to track user activity across the site and pass that with a form handler. I know the iframe does that but form handlers do not – at least not that I can tell from what I’ve been reading. One option is to use the Pardot API but that is a little out my league. Are you aware of any new information or WordPress plugins that may be able to accomplish this?
Hi Remi, Thanks so much! I have not done this myself, but the tips in this article might point you in the right direction: https://help.salesforce.com/articleView?id=000322102&type=1&mode=1/.
Hi Jenna, I’m actually using the form handler for the external leads (produced by a partner media agency) to be directly entered into my Pardot. They asked me to provide the external field names, i cannot find them and it’s hard to find info on them on the net. Would you be kind enough to point me in the right direction ? Best, Stéphanie
Hi Stephanie,
The external field names are created within your Pardot form handler. Here’s a screenshot of what it looks like https://jennamolby.com/wp-content/uploads/2016/03/pardot-form-handler-map-fields.jpg.
Hi Jenna!
Thanks for everything you write about Pardot it’s always so extremely helpful!
I came across a problem when using Form Handlers and WordPress, I need prospects to be cookied in to be able to use Contact Form 7 and Gravity Forms but that makes the new ‘Comment’ or Message Field come in as a default older text (not the new message that someone is trying to send via the form) It’s not the end of the world because two forms come into my inbox at once – one with the Pardot score/prospect and the other with what was input in Contact Form 7, but I wonder if you have any suggestions to fix that? Do I have to create a new default field on Salesforce to avoid this from happening? Thank you!
Hi Emelie, So happy you find my content helpful 🙂 I’ve not run into this issue before. Are you passing the cookie information through your form handler? Cheers, Jenna