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 (generated in Company Settings)

Step 1: Get Your Credentials

Finding Your Company ID

  1. Log in to your LeadMachine dashboard
  2. Navigate to Company from the sidebar
  3. Your Company ID is displayed at the top of the page
  4. Copy this ID

Generating Your API Key

  1. In Company Settings, scroll to WordPress Integration
  2. Click the Generate button
  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: Download the Plugin

  1. Visit the WordPress Plugin Download Page
  2. If you're logged in, click Download Plugin
  3. If not logged in, fill out the form to receive a download link by email
  4. Download the leadmachine-connector.zip file


Step 3: Install in WordPress

  1. Log in to your WordPress admin panel
  2. Navigate to Plugins > Add New
  3. Click Upload Plugin at the top
  4. Click Choose File and select leadmachine-connector.zip
  5. Click Install Now
  6. Click Activate Plugin


Step 4: 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:
- Email (required) - Your email field - First Name - Name field (first) - Last Name - Name field (last) - Phone - Phone field - Company - Company/organization field - Message - Message/textarea field
  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]".


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?

WordPress DataUsed In Email As
----------------------------------
Post TitleSubject line and headline
Post ContentAI-summarized body content
Featured ImageHeader image in email
Permalink"Read Full Article" button
CategoriesCampaign filtering
Publish DateSequential ordering (oldest first)
Form FieldLeadMachine Field
-------------------------------
First NameFirst Name
Last NameLast Name
EmailEmail (primary contact)
PhonePhone (contact)
CompanyCompany Name
MessageLead Notes

Additional fields are recorded in the lead notes for reference.


Troubleshooting

"API key is required" Error

Your WordPress plugin needs the API key from Company Settings.

  1. Go to LeadMachine > Company Settings > WordPress Integration
  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 in Company Settings
  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

When a new version is available:

  1. Download the latest leadmachine-connector.zip
  2. Deactivate the current plugin
  3. Delete the old plugin
  4. Upload and activate the new version
  5. Your settings will be 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: January 2026

Frequently Asked Questions

Search for "LeadMachine Connector" in WordPress plugins, install, activate, and enter your API key from LeadMachine settings.

The plugin captures submissions from its built-in form, Gravity Forms, and any form using the LeadMachine shortcode.

Enable this to sync your WordPress posts to LeadMachine for AI-powered email newsletters based on your blog content.