Skip to content

How to Integrate Facebook Leads with EmailOctopus

EmailOctopus is a straightforward, affordable email marketing platform with a generous free tier, popular with creators, newsletters, nonprofits, and small businesses. It doesn't have a native Facebook Lead Ads integration, so LeadSync fills the gap: new leads land in the EmailOctopus list you choose in under a minute.

Before you start

  • You need an EmailOctopus account. API access is available on every plan, including the free plan, so you don't need to upgrade just to connect.
  • You need admin access to the Facebook page generating leads.
  • You need a LeadSync account. A free trial is enough to get set up and send a test lead.

Step 1: Create a list in EmailOctopus

Each Facebook lead form should map to its own EmailOctopus list so you can target welcome automations independently.

  1. In EmailOctopus, go to Lists.
  2. Click Create a list and give it a clear name (e.g. Facebook - Shipping Container Leads).
  3. Leave it empty. LeadSync will add contacts as leads come in.

If you want an automated welcome email, set up an EmailOctopus automation triggered when a contact joins this list.

Step 2: Generate your EmailOctopus API key

  1. In EmailOctopus, click your account name and choose Account.
  2. Open Integrations & API.
  3. Click Create a new API key and label it LeadSync.
  4. Copy the key (it starts with eo_). Keep it somewhere safe.

Step 3: Add the EmailOctopus connection in LeadSync

  1. Log in to LeadSync and click Connections → Add Connection.
  2. Select EmailOctopus from the dropdown.
  3. Paste the API key into the EmailOctopus API key field and give the connection a recognisable name (e.g. EmailOctopus - main).
  4. (Optional) In the Tags field, enter one or more comma separated tags (e.g. facebook-lead, shipping-containers). Every contact synced through this connection gets these tags. EmailOctopus creates any tag that doesn't exist yet, so you don't need to pre-create them.
  5. Click Update connection. LeadSync fetches your EmailOctopus lists.
  6. Pick the List you created in Step 1 and click Update.

Note

Selecting a list is required. If no list is chosen, leads have nowhere to go and won't be delivered.

New contacts are added as subscribed, since the person already consented on your Facebook lead form.

Step 4: Pair a Facebook lead form to your EmailOctopus connection

  1. Go to Lead Forms → Add Facebook Lead Form.
  2. Select the Page the leads come from.
  3. Select the Form you want to sync.
  4. Select the EmailOctopus connection you just created.
  5. Map each Facebook field to an EmailOctopus field:
    • Facebook email → EmailOctopus Email (required)
    • Facebook first_name → EmailOctopus FirstName
    • Facebook last_name → EmailOctopus LastName
    • Any custom Facebook field → type the EmailOctopus field tag you want it stored under (e.g. a custom field's tag from your list).
  6. Click Update Notifications.

If you don't map any fields, LeadSync still delivers the email address and splits the lead's full name into FirstName and LastName automatically.

New leads submitted through that form will arrive in the chosen EmailOctopus list within seconds.

Test the connection

Here's how to test your connection. A test lead should appear in EmailOctopus under your list's Contacts, with a subscribed status and any tags you configured.

Troubleshooting

Leads aren't appearing in EmailOctopus. First confirm a list is selected on the connection (Connections → edit the connection → the List dropdown should show your list). A connection saved without a list is the most common cause. Then check your user log in LeadSync under Account → Logs for an EmailOctopus Error: line. A "No list selected" message confirms the list wasn't saved.

EmailOctopus returns "Your API key is invalid." Generate a new key in EmailOctopus (Account → Integrations & API → Create a new API key), paste it into the LeadSync connection, and click Update.

The same lead keeps appearing. EmailOctopus treats the email address as the unique identifier, so repeat submissions update the existing contact rather than creating duplicates. If you're seeing true duplicates, check whether two different Facebook forms point at the same EmailOctopus list.

A tag isn't showing up. Tags are applied exactly as typed and are case sensitive. Check the Tags field on the connection for typos or stray spaces.

Connect Facebook / Meta Leads to Emailoctopus

Start syncing leads from your ad platform in under 2 minutes. No credit card required.

Start Free Trial