Documentation
Gravity Forms Integration
Send Gravity Forms submissions directly to LeadMachine. When someone fills out your Gravity Form, a lead is automatically created in your LeadMachine account.
Prerequisites
- LeadMachine WordPress Connector plugin (v2.0.0 or higher)
- Gravity Forms plugin installed and activated
- Company ID and API Key configured in the LeadMachine plugin
Enabling the Integration
- In WordPress admin, go to LeadMachine menu
- Click the Gravity Forms tab
- Check Enable Integration
- Click Save Settings
Configuring Form Mappings
Each Gravity Form needs to be configured separately so LeadMachine knows which fields contain the lead data.
Step 1: Enable the Form
Check the box next to the form name to enable it for LeadMachine.
Step 2: Map Fields
For each enabled form, map your Gravity Forms fields to LeadMachine lead fields:
- Email (Required) - The email field from your form
- First Name - First name or the first part of a Name field
- Last Name - Last name or the last part of a Name field
- Phone - Phone number field
- Company - Company or organization field
- Message - Message, comments, or any textarea field
Tip: For Name fields in Gravity Forms, you'll see options like "Name - First" and "Name - Last" in the dropdowns. Select the appropriate sub-field.
Step 3: Add Tags (Optional)
You can add tags specific to each form. For example:
- Contact form: "Contact Request"
- Quote form: "Quote Request, Hot Lead"
- Newsletter signup: "Newsletter"
Tags help you filter and organize leads in LeadMachine.
Step 4: Save Settings
Click Save Settings to apply your mappings.
Default Tags
In addition to form-specific tags, you can set Default Tags that apply to ALL Gravity Forms submissions. This is useful for:
- Identifying the lead source (e.g., "Website, Gravity Forms")
- Applying team-wide categorization
- Campaign tracking
How It Works
- Visitor submits your Gravity Form
- Gravity Forms processes the submission normally
- LeadMachine plugin captures the data after submission
- Data is sent securely to your LeadMachine account
- A new lead is created with:
Viewing Gravity Forms Leads
- Log in to LeadMachine
- Go to Leads
- Filter by source containing "Gravity Forms"
- Or search for the tags you applied
Each lead shows:
- Contact information from the form
- Source URL where the form was submitted
- Tags you configured
- Message/notes from the submission
Troubleshooting
Form Not Sending to LeadMachine
- Check plugin connection - Go to LeadMachine > Connection tab and verify Company ID and API Key are set
- Verify form is enabled - In the Gravity Forms tab, ensure the checkbox next to your form is checked
- Map the email field - Email is required. Make sure it's mapped to your form's email field
- Check WordPress logs - Enable debug logging to see any error messages
Leads Missing Information
- Verify all fields are mapped correctly
- For Name fields, make sure you're selecting the sub-fields (First, Last) not the parent field
- Check that the form field IDs haven't changed after you saved mappings
Duplicate Leads
LeadMachine uses email address to detect duplicates. If you're seeing duplicates:
- The same person may have used different email addresses
- You can merge duplicates in the LeadMachine dashboard
Tags Not Appearing
- Check that tags are entered correctly (comma-separated)
- Save settings after adding tags
- New tags will be created automatically in LeadMachine
Advanced: Multiple Forms
You can configure multiple Gravity Forms, each with different field mappings and tags:
- Contact Form - Map name, email, phone, message
- Quote Request - Map name, email, company, phone + tag "Quote Request"
- Newsletter Signup - Just map email + tag "Newsletter"
- Job Application - Map name, email, phone + tag "Job Application"
Each form can have unique tags to help you route and prioritize leads.
API Details
Gravity Forms submissions are sent to the same secure endpoint as the built-in LeadMachine form:
- Endpoint:
https://app.leadmachine.fyi/api/leads/wordpress-submit.php - Method: POST
- Authentication: Company ID + API Key
- Data: Form field values mapped to lead fields
All data is transmitted over HTTPS.
Last Updated: December 2025