Overview
The Gravity Forms HighLevel Add-On connects Gravity Forms to HighLevel, making it easy to turn form submissions into contacts and, optionally, pipeline opportunities.
Create a HighLevel feed for any form, map standard and custom contact fields, apply tags, and control when submissions are sent using conditional logic. For sales workflows, the add-on can create an opportunity in a selected pipeline stage, assign it to a user, and populate its name and monetary value using Gravity Forms merge tags.
The result is a flexible way to move leads and sales data from WordPress into HighLevel without manually copying submission details between platforms.
Key Benefits
- Sync Gravity Forms submissions to HighLevel automatically
- Create new contacts or update existing contacts using HighLevel’s duplicate settings
- Map names, email addresses, phone numbers, addresses, and other contact details
- Send Gravity Forms values to HighLevel custom fields
- Apply fixed or dynamically generated tags to contacts
- Optionally create pipeline opportunities for submitted entries
- Select the opportunity’s pipeline stage and assigned user
- Build opportunity names and monetary values with Gravity Forms merge tags
- Use conditional logic to control which submissions are sent
- Delay feed processing until payment is received
- Capture affiliate IDs from an
am_idURL parameter or cookie - Send affiliate IDs, products, and sale amounts to HighLevel custom fields
- Store HighLevel contact and opportunity IDs with the Gravity Forms entry
- Validate HighLevel credentials from the WordPress settings page
- Cache custom fields, pipelines, and users to keep feed configuration responsive
- Customize contact, opportunity, and affiliate data with developer filters
How It Works
Connect the add-on to a HighLevel sub-account using a Private Integration Token and Location ID, then create a HighLevel feed from the settings area of a Gravity Form.
When a visitor submits the form, the add-on:
- Collects the form values configured in the feed.
- Creates or updates a HighLevel contact using the mapped contact and custom fields.
- Applies any configured fixed or dynamic tags.
- Sends affiliate attribution data when affiliate tracking is enabled.
- Stores the returned HighLevel contact ID with the Gravity Forms entry.
- Optionally creates an opportunity for the contact in the selected pipeline stage.
- Stores the resulting opportunity ID with the entry for future reference.
HighLevel controls how duplicate contacts are matched through the sub-account’s Allow Duplicate Contact setting. At least an email address or phone number must be mapped so HighLevel can create or update the contact.
For opportunity workflows, enable Create Opportunity in the feed and select a pipeline stage. You can then use static text and Gravity Forms merge tags to define the opportunity name and monetary value, as well as assign the opportunity to a HighLevel user.
Conditional logic can restrict the feed to submissions that meet specific criteria. Forms that collect payments can also delay processing until payment is received, helping ensure that HighLevel receives confirmed customers and accurate sale values rather than incomplete transactions.
Affiliate tracking can capture an am_id value from the visitor’s URL and retain it in a cookie for 30 days. The feed can send this ID, along with product and sale information, to dedicated HighLevel contact fields for use in HighLevel workflows. The add-on sends attribution data but does not create commissions or payouts.
This release connects one HighLevel location to each WordPress site using a location-level Private Integration Token.
Please log in to access this content. Log in
Requirements
- WordPress 6.5+
- PHP 7.4+
- Gravity Forms 2.9.24+
- A HighLevel account and sub-account
- A HighLevel Location ID
- A HighLevel Private Integration Token
Changelog
0.1.0-alpha.1
2026-09-09
- First alpha release of the Gravity Forms HighLevel Add-On.
- Added a Gravity Forms feed add-on that upserts HighLevel contacts and optionally creates pipeline opportunities.
- Added affiliate referral tracking so feeds can send a HighLevel affiliate ID, product, and sale amount from Gravity Forms submissions.
- View more
Documentation
HighLevel Add-On Documentation
Connects Gravity Forms to HighLevel so form submissions can create or update contacts, apply tags, populate custom fields, and optionally create pipeline opportunities. Includes conditional feed processing, payment-delayed processing, and affiliate attribution support.
This section is a short usage guide for connecting HighLevel and sending form submissions as contacts. Developer filters and API details are covered above.
Connect HighLevel
- In HighLevel, switch into the sub-account that should receive contacts (not the agency view).
- Create a Private Integration Token under Settings → Private Integrations. Copy it immediately.
- Copy the Location ID from Settings → Business Profile, or from the URL after
/location/. - In WordPress, open Forms → Settings → HighLevel.
- Paste the token and Location ID. A green check means the connection succeeded.
HighLevel custom fields, pipelines, and users are cached for one hour. After you add those in HighLevel, click Clear custom field, pipeline, and user cache.
The Labs notice on this screen is expected. This add-on is not officially supported.
Create a feed
Open the form, then Settings → HighLevel → Add New. Give the feed a name you will recognize later.
Map contact fields
Map form fields to HighLevel contact fields. Email or phone is required so HighLevel can create or update the contact.
Address fields can stay unmapped if the form does not collect them.
Custom fields and tags
Use Custom Fields to send extra form values into HighLevel custom fields. Choose the HighLevel field first, then the form field.
In Tags, enter comma-separated tags. You can mix fixed tags with merge tags so a form choice becomes a tag.
Create an opportunity (optional)
Leave Create Opportunity off for a simple lead capture. Turn it on when you want a pipeline deal on the same contact.
If you enable it:
- Choose a Pipeline Stage (required). Create the pipeline in HighLevel first if the dropdown is empty, then clear the cache.
- Set an Opportunity Name.
{form_title}is the default. - Optionally add a Monetary Value (merge tags are supported) and an Assigned User.
A missing pipeline stage does not stop the contact from being created. The opportunity is created after the contact.
Affiliate tracking (optional)
Enable this only if you use HighLevel affiliates and have dedicated contact custom fields for Affiliate ID, Product, and Sale Amount.
Typical setup:
- Send visitors to the form with
?am_id=their-id. The add-on stores that value in a cookie for 30 days. - Leave Affiliate ID on Captured URL parameter / cookie (am_id) unless you map a hidden form field instead.
- Map each value to its own HighLevel custom field. Do not reuse a field already mapped under Custom Fields.
- In HighLevel, use a workflow with Add Leads Under an Affiliate (Custom Mapping) to assign the contact.
This add-on sends attribution on the contact. It cannot create commissions or payouts.
After someone submits
- Open Forms → Entries for that form.
- Confirm a HighLevel note on the entry, such as a contact ID.
- In the HighLevel sub-account, open Contacts and search the email or phone.
If the contact is missing, check that you are in the same sub-account as the Location ID, that the token was created in that sub-account, and that the entry note does not show an API error.




