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

  1. In WordPress admin, go to LeadMachine menu
  2. Click the Gravity Forms tab
  3. Check Enable Integration
  4. 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

  1. Visitor submits your Gravity Form
  2. Gravity Forms processes the submission normally
  3. LeadMachine plugin captures the data after submission
  4. Data is sent securely to your LeadMachine account
  5. A new lead is created with:
- Name, email, phone mapped from your field settings - Source set to "Gravity Forms: [Form Name]" - Tags applied (form-specific + default) - Message/notes captured


Viewing Gravity Forms Leads

  1. Log in to LeadMachine
  2. Go to Leads
  3. Filter by source containing "Gravity Forms"
  4. 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

  1. Check plugin connection - Go to LeadMachine > Connection tab and verify Company ID and API Key are set
  2. Verify form is enabled - In the Gravity Forms tab, ensure the checkbox next to your form is checked
  3. Map the email field - Email is required. Make sure it's mapped to your form's email field
  4. Check WordPress logs - Enable debug logging to see any error messages

Leads Missing Information

  1. Verify all fields are mapped correctly
  2. For Name fields, make sure you're selecting the sub-fields (First, Last) not the parent field
  3. 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

  1. Check that tags are entered correctly (comma-separated)
  2. Save settings after adding tags
  3. 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

Frequently Asked Questions

Install the LeadMachine WordPress plugin, then in Gravity Forms settings, enable the LeadMachine feed.

Yes, the feed settings let you map any Gravity Forms field to LeadMachine lead fields.

Yes, configure tags in the feed to automatically tag leads based on which form they submitted.