🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!

Gravity Forms Account Engagement (Pardot) Premium Add-on Setup Guide

Updated 5 min read Gravity Forms CRM & Email Marketing
On this page
  1. Step 1: Install and Activate Your License
  2. Step 2: Create a Connected App in Salesforce
  3. Step 3: Connect the Add-on
  4. Step 4: Create a Feed and Map the Prospect
  5. Step 5: Campaign, Lists and Conditions
  6. Step 6: Check the Result on the Entry
  7. When Account Engagement Refuses a Lead
  8. Not Included in Version 1.0
  9. Troubleshooting

The Gravity Forms Account Engagement (Pardot) Premium Add-on sends your Gravity Forms submissions to Marketing Cloud Account Engagement, formerly Pardot, the moment a form is sent. Each lead becomes a prospect, or updates the existing prospect with the same email, with your custom fields, a campaign and the static lists you choose.

This guide covers the Salesforce connected app, connecting the add-on, setting up a feed, what happens when something goes wrong, and troubleshooting.

System Requirements & Prerequisites

  • WordPress: Version 6.5 or higher, with the admin served over HTTPS
  • PHP: Version 7.4 or higher
  • Gravity Forms: Version 2.9 or higher
  • Account Engagement: An account connected to Salesforce, its Business Unit ID, and a Salesforce user allowed to create connected apps (or an admin who can create one for you)
  • GravityExtra license: The add-on installed, activated and licensed with an active GravityExtra license key

Step 1: Install and Activate Your License

  1. In WordPress go to Plugins → Add New → Upload Plugin, upload the add-on ZIP file and click Activate.
  2. Go to Forms → Settings → Pardot, enter your key in the Gravity Extra License section and click Activate License.
  3. Reload the page. The Account Engagement connection section appears. Copy the Callback URL shown there; you need it in the next step.

Step 2: Create a Connected App in Salesforce

  1. In Salesforce Setup, open App Manager and create a new connected app (or an external client app, depending on your Salesforce edition).
  2. Turn on Enable OAuth Settings and paste the Callback URL from the add-on.
  3. Add the OAuth scopes Manage Pardot services (pardot_api) and Perform requests at any time (refresh_token, offline_access).
  4. Save, wait a few minutes for Salesforce to activate the app, then open Manage Consumer Details and copy the Consumer Key and Consumer Secret.
  5. Find your Business Unit ID: in Setup search for “Business Unit Setup” (or “Pardot Account Setup”). It starts with 0Uv.

Step 3: Connect the Add-on

  1. In Forms → Settings → Pardot enter the Business Unit ID, choose Production or Sandbox, and enter the Consumer Key and Consumer Secret.
  2. Only if your org blocks logins through login.salesforce.com, enter your My Domain login URL (for example https://yourcompany.my.salesforce.com).
  3. Optional: enter a Backup email for failed submissions.
  4. Click Save Settings, then Connect to Account Engagement. Log in to Salesforce with a user who has access to Account Engagement and allow access. You return to the settings page and see Connected to Account Engagement.
Account Engagement connection settings: Business Unit ID, instance, Consumer Key, saved secret, callback URL and a successful connection
The connection settings after connecting to Account Engagement.

The Consumer Secret is never shown again after saving; the page only tells you that a secret is saved and its last four characters. Leave the field empty to keep it. If you change the Consumer Key, the instance or the login URL, the connection is removed and you connect again. Disconnect revokes access at Salesforce and forgets the connection.

Step 4: Create a Feed and Map the Prospect

  1. Open a form and go to Settings → Pardot, then click Add New.
  2. Under Prospect fields choose the form field for Email (required) and, if you have them, first and last name, salutation, company, job title, industry, phone, website and address. An Address field fills address line 1 and 2, city, state, postal code and country.
  3. Under Custom fields type the API field name of a custom prospect field (Account Engagement Settings → Object and Field Configuration → Prospect Fields), for example Product_Interest, and choose the form field that fills it. The __c ending is added for you.
  4. Optional: fill Comments with merge tags, for example the answer of a “What do you need?” field.
Pardot feed: prospect fields mapped to form fields, a custom field and the Comments text
Prospect fields, a custom field and Comments for a demo request form.

Prospects are matched by email. When a prospect with the same email exists, the most recently active one is updated; otherwise a new prospect is created. Empty answers are not sent, so they never clear values you already have.

Step 5: Campaign, Lists and Conditions

  • Campaign: the campaign new prospects are created in, read from your account. Existing prospects keep their campaign.
  • Add to lists: tick the static lists the prospect should join, for example a newsletter list. Dynamic lists are not shown because they fill themselves from their rules.
  • Conditions: send only some submissions, for example only when a consent box is ticked.
Pardot feed: campaign selected and two static lists ticked
The campaign for new prospects and the static lists to join.

Step 6: Check the Result on the Entry

Open an entry in Forms → Entries. The Account Engagement box shows the prospect ID, and an entry note says how many lists the prospect was added to. If a list could not be updated, the note names it and gives the reason, while the prospect itself is kept. Click Send to Account Engagement again to resend the entry after fixing the cause; only users who can edit entries see this button.

When Account Engagement Refuses a Lead

  • Refused data: for example an unknown custom field name or a value of the wrong type. The entry note quotes the reason and the lead is emailed to your backup address.
  • Expired or revoked connection: the add-on renews its access automatically. If Salesforce refuses (for example the app was blocked or the user lost access), the entry note asks you to connect again.
  • Busy or unreachable: the add-on tries once more after a short pause. If it still fails, the lead goes to the backup email and you can resend it later.

Not Included in Version 1.0

  • Visitor tracking (linking the submission to the visitor’s browsing history), form handlers, prospect assignment to users, scoring, tags and opportunities.
  • Updating or deleting prospects when an entry is edited or deleted in WordPress.

Troubleshooting

  • Salesforce shows “redirect_uri_mismatch”: the Callback URL in the connected app must match the one in the add-on exactly.
  • “Account Engagement refused access”: check the Business Unit ID and that Production or Sandbox matches your account. Training and developer orgs use Sandbox.
  • “Salesforce did not return a refresh token”: add the “Perform requests at any time” scope to the connected app and connect again.
  • Campaigns or lists are missing: they are read from your account and remembered for an hour. Click Test connection in the settings, then reload the feed.
  • Nothing is sent: check that the Email field is mapped and filled in, that the feed’s condition matches, and that your license is active.

Need help? Open a support ticket.

Still need help?

Our support team answers tickets every day, usually within a few hours.

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr