WordPress Plugin Setup Guide

The LeadMachine WordPress Connector plugin connects your WordPress website to LeadMachine with three powerful features:

• Lead Capture Forms - Built-in forms and Gravity Forms integration to capture leads
• Blog Post Sync - Automatically sync blog posts for AI-powered email newsletters
• Auto-Sync on Publish - New posts automatically sync when published

Prerequisites

• Active LeadMachine account
• WordPress website (version 5.0 or higher)
• Administrator access to your WordPress site
• Your LeadMachine Company ID
• Your LeadMachine API Key (both found on the Integrations page)

Step 1: Get Your Credentials

Both your Company ID and API Key live on the Integrations page.

Open the Integrations page

1. Log in to LeadMachine
2. Click your profile in the top-right navbar and select Integrations

1. Open the WordPress card

> Only Admin and SuperAdmin users can manage integrations. If you don't > see Integrations, ask an admin on your account.

Get your Company ID and API Key

1. Your Company ID is shown at the top of the Integrations page — copy it
2. In the WordPress card, click Generate New Key
3. Copy the API key that appears
4. Keep this key secure - you'll need it during plugin setup

Important: The API key is required for security. Without it, form submissions will be rejected.

Step 2: Install the Plugin

Option A: From the WordPress Plugin Directory (recommended)

The fastest way - install directly from your WordPress admin, no download or login needed:

1. In WordPress, go to Plugins > Add New
2. Search for LeadMachine Connector
3. Click Install Now, then Activate

You can also view the listing at wordpress.org/plugins/leadmachine-connector.

Option B: Manual upload

If you need a specific version or want to install offline:

1. Download leadmachine-connector.zip from the plugin download page
2. In WordPress, go to Plugins > Add New > Upload Plugin
3. Choose the ZIP file, click Install Now, then Activate Plugin

Step 3: Configure the Plugin

After activation, you'll find LeadMachine in your WordPress admin menu.

Connection Tab

1. Enter your Company ID
2. Enter your API Key
3. Leave the API URL as default (https://app.leadmachine.fyi)
4. Click Save Settings

Form Styling Tab (Optional)

Customize the built-in LeadMachine form:

• Form Title
• Form Description
• Button Text and Color
• Background and Label Colors
• Success Message

Using the Built-in Form

Add the LeadMachine form to any page or post using the shortcode:

[leadmachine_form]

Shortcode Options

Custom title and description:

[leadmachine_form title="Contact Us" description="We'd love to hear from you!"]

Apply tags to leads:

[leadmachine_form tags="Newsletter,Website"]

Custom button:

[leadmachine_form button_text="Send Message" button_color="#667eea"]

Gravity Forms Integration

If you use Gravity Forms, you can automatically send submissions to LeadMachine.

Enabling Gravity Forms

1. Go to LeadMachine > Gravity Forms tab
2. Check Enable Integration
3. Set Default Tags (optional) - applied to all GF submissions

Mapping Form Fields

For each Gravity Form:

1. Check the box next to the form name to enable it
2. Map your form fields to LeadMachine fields:

1. Add form-specific tags (optional)
2. Click Save Settings

Testing

Submit a test entry on your Gravity Form. Within seconds, check your LeadMachine leads - you should see the new lead with source "Gravity Forms: [Form Name]".

Conversion & ROAS Tracking (Google Ads + GA4)

Fire a Google Ads conversion - and optionally a GA4 purchase event with real revenue - when a form is completed. This works with the built-in LeadMachine forms and with connected Gravity Forms, including Gravity Forms + Stripe checkout. All values are dynamic; nothing is hard-coded.

Settings (LeadMachine > Google Ads tab)

• Conversion ID - your Google Ads conversion ID, e.g. AW-123456789 (Google Ads > Goals > Conversions > Tag setup). The global gtag.js tag for this account must be installed on your site (via your Google tag, Google Site Kit, or a header/footer snippet).
• Conversion Label - the conversion action's label (the part after the slash in the tag setup). Optional.
• Send GA4 purchase event - also fires a GA4 purchase event with the transaction value + currency, for revenue / ROAS reporting.
• Confirmation page - optional but recommended for payment forms. If set, the conversion fires only when the visitor lands on a page whose URL contains this text (e.g. payment-success), so abandoned checkouts are never counted.

Where the value comes from (never hard-coded)

• In-form payment (Gravity Forms Stripe/PayPal add-on): the amount + currency are read automatically from the entry.
• Hosted / off-site Stripe checkout: pass the amount on the confirmation redirect's query string - add value={total}&currency=USD (use the merge-tag picker for the total/price). The keys must be exactly value and currency.

Gravity Forms + Stripe hosted checkout - step by step

1. In LeadMachine > Google Ads: enter your Conversion ID and Label, tick Send GA4 purchase event, and set Confirmation page to your Stripe success page slug (e.g. payment-success).
2. In the Gravity Form's Confirmation (Page Redirect), enable Pass Field Data via Query String and include:

   value={your price merge tag}&currency=USD
   

1. Ensure the global Google tag (gtag.js) for your Ads account is installed site-wide.

On a completed purchase the plugin fires the Google Ads conversion and (if enabled) a GA4 purchase, both carrying the value + currency, and only on the confirmation page - so abandoned checkouts are excluded.

Verify

Run a test purchase and open Google Tag Assistant or GA4 DebugView on the confirmation page - you should see conversion and purchase events with value and currency populated. (Requires plugin v2.7.5 or newer.)

Blog Post Sync for Email Newsletters

New in v2.3.0 - Turn your WordPress blog into an automated email newsletter! Sync your blog posts to LeadMachine and let Ledo AI create engaging email summaries that drive traffic back to your site.

Why Use Blog Post Sync?

• Automated Content - No need to manually write newsletter emails
• AI-Powered Summaries - Ledo creates engaging email content from your posts
• Sequential Delivery - Posts sent oldest-to-newest, perfect for evergreen content
• Drive Traffic - Each email links back to the full article on your site
• Category Targeting - Choose which blog categories to include

Setting Up Post Sync in WordPress

1. Go to LeadMachine > Post Sync tab in your WordPress admin
2. Toggle Enable Post Sync to ON
3. Select which Categories to sync (check the boxes for each category you want)
4. Click Sync Categories to send category data to LeadMachine
5. Click Sync All Posts Now to sync your existing posts

Tip: You'll see a count of synced posts and the last sync time in the Post Sync tab.

Auto-Sync on Publish

Once enabled, new posts are automatically synced to LeadMachine when you publish them. No manual action required - just keep blogging!

What Gets Synced

Creating a Blog Newsletter Campaign in LeadMachine

After syncing posts from WordPress:

1. Go to Email Campaigns in LeadMachine
2. Click New Campaign and select Nurture as the type
3. In the campaign settings, set Content Source to WordPress Posts
4. Select which Categories to include in this campaign
5. Optionally enable Loop content to restart from the beginning when all posts are sent
6. Set the Email Frequency (e.g., 7 days = weekly newsletter)
7. Configure your branding (logo, colors, footer text)
8. Activate the campaign

How It Works

When a lead is enrolled in your WordPress newsletter campaign:

1. Week 1: They receive your oldest post (AI-summarized)
2. Week 2: They receive the next oldest post
3. Week 3: And so on...
4. When complete: Either marked as finished, or loops back to the first post

Each email includes:

• Your company branding (logo, colors)
• AI-generated subject line and preview text
• Featured image from the post
• 2-3 paragraph summary of the post content
• "Read Full Article" button linking to your site
• Unsubscribe link (per-campaign)

Best Practices

• Use categories strategically - Create categories like "Tips", "Case Studies", or "Product Updates" to segment content
• Add featured images - Posts with featured images make more engaging emails
• Write quality content - AI summarization works best with well-written, substantive posts
• Weekly cadence - 7-day delays work well for most blog newsletters
• Evergreen content - This works great for content that stays relevant over time

What Data is Captured?

Additional fields are recorded in the lead notes for reference.

Troubleshooting

"API key is required" Error

Your WordPress plugin needs the API key from the Integrations page.

1. In LeadMachine, open Integrations (profile menu, or Settings > Integrations) and select the WordPress card
2. Generate an API key if you haven't already
3. Copy and paste it into your WordPress plugin settings

"Invalid API key" Error

The API key doesn't match what's in your LeadMachine account.

1. Regenerate the API key on the Integrations page (WordPress card)
2. Update the key in your WordPress plugin settings
3. Save settings and try again

Forms Not Syncing

1. Verify Company ID and API Key are correct
2. Check that your WordPress site can make HTTPS requests
3. For Gravity Forms, ensure the form is enabled in the mapping settings
4. Check WordPress error logs for details

Gravity Forms Not Appearing

1. Ensure Gravity Forms plugin is installed and activated
2. Create at least one form in Gravity Forms first
3. Refresh the LeadMachine settings page

Updating the Plugin

If you installed from the WordPress Plugin Directory (Option A), updates are one-click:

1. In WordPress, go to Plugins (or Dashboard > Updates)
2. Click Update now under LeadMachine Connector

Your Company ID, API Key, and form / Gravity Forms settings are preserved across updates.

For a manual (Option B) install, upload the newer ZIP the same way you installed it - your settings are preserved.

Getting Help

If you encounter issues:

• Email: [email protected]
• Include your Company ID and WordPress version
• Describe the issue and any error messages

Last Updated: August 2026