Connect Fluent Forms to EmailOctopus
Connect Fluent Forms to EmailOctopus and every form submission becomes a subscriber in the EmailOctopus list you choose. ClickSyncr for EmailOctopus adds a native Fluent Forms integration with per-form feeds: connect your API key once, pick a list, map your fields, save. No code and about two minutes per form.
Before you begin
You need three things: the ClickSyncr for EmailOctopus plugin activated, Fluent Forms active, and a EmailOctopus account with permission to create an API key. The key is stored once and shared across every supported builder on the site.
Get your EmailOctopus API key
- Log in to EmailOctopus and go to Developer → API keys (dashboard.emailoctopus.com/developer/api-keys).
- Click Add key, name it, and copy the key.
- Paste it into any ClickSyncr EmailOctopus panel. One key serves the whole site: once one builder saves it, every other builder reuses the connection automatically.
Treat the key like a password. Anyone holding it can read and modify your EmailOctopus audience.
Fluent Forms setup, step by step
- Open the form’s integrations. Edit a form, then Settings & Integrations → Marketing & CRM Integrations, and add EmailOctopus (ClickSyncr).
- Configure the feed. Pick the list, set the email field, map the rest, and keep the feed enabled.
- Optional: set a consent field. Set an optional consent field (a checkbox, acceptance or radio). A ticked box subscribes the contact right away; an unticked box sends them as pending, so EmailOctopus asks for confirmation before they join the list.
- Save the feed. Every new submission now syncs to EmailOctopus.
Email, name, and list fields
Every builder maps the same schema: Email (required) plus the selected list’s own EmailOctopus fields (first name, last name and any you define), mapped by tag with each field’s type shown. Fields are per list, so the mapping rows follow the list you choose, and number fields are sent as real numbers, matching the type you set in EmailOctopus. EmailOctopus upserts contacts by email, so a repeat submission updates the same contact instead of creating a duplicate. An unmapped field is simply skipped and never overwrites existing data with a blank value.
Typed fields and honest status choices
Two details make this integration feel native. First, fields are per list: pick a list and the mapping rows show that list’s own fields, including typed number fields that are sent as real numbers. Second, the panel reads the list’s real double opt-in setting, so the subscriber-status choices always describe what will actually happen: subscribed right away, or pending until EmailOctopus’s confirmation email is clicked.
Verify the sync
Submit the form on the front end (not the admin preview) with a test address you can recognise, filling every mapped field. In EmailOctopus, open the list and find the contact. A pending contact means EmailOctopus sent its confirmation email first: either the list uses double opt-in, the form’s status is set to Pending, or the consent box was left unticked. Back in WordPress, the ClickSyncr entry in the admin bar shows per-form sync counts and the last error, if any: a quick pulse check without leaving the site.
Troubleshooting
| Symptom | Cause and fix |
|---|---|
| Lists don’t load after pasting the key | Create the key under Developer → API keys in the EmailOctopus dashboard and paste it exactly. |
| The contact shows as pending | That’s the confirmation flow: the list uses double opt-in, the form’s status sends pending, or the consent box was unticked. EmailOctopus subscribes them when they click the confirmation email. |
| A field stays empty on the contact | Fields are per list. Check the mapping row and confirm the field exists on the list you selected, with a compatible type (number fields only accept numeric values). |
| Sync stopped working | Check the admin-bar health menu for the last error. An invalid or rotated API key is the usual cause; paste the new key in any builder and it updates everywhere. |
Does this work with the free Fluent Forms?
Yes. The EmailOctopus (ClickSyncr) integration registers in the free Fluent Forms as a native integration feed.
Can one site sync several forms to EmailOctopus?
Yes. Each form carries its own feed with its own list and mapping, all sharing the one site-wide key.
Other form builders
ClickSyncr for EmailOctopus also connects Contact Form 7 · WPForms · Gravity Forms · Ninja Forms · Formidable Forms · Forminator. Overview and features: EmailOctopus integration for WordPress. Browse all ClickSyncr integrations.
“EmailOctopus” is a trademark of Three Hearts Digital Ltd. ClickSyncr for EmailOctopus is an independent integration and is not affiliated with, endorsed by, or sponsored by Three Hearts Digital Ltd.