Connect Contact Form 7. Send every lead to EmailOctopus.

Connect Contact Form 7 to EmailOctopus

Connect Contact Form 7 to EmailOctopus and every form submission becomes a subscriber in the EmailOctopus list you choose. ClickSyncr for EmailOctopus adds a ClickSyncr EmailOctopus tab right in the Contact Form 7 editor: 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, Contact Form 7 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

1. Log in to EmailOctopus and go to Developer → API keys (dashboard.emailoctopus.com/developer/api-keys).
2. Click Add key, name it, and copy the key.
3. 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.

Contact Form 7 setup, step by step

1. Open your form and switch to the ClickSyncr EmailOctopus tab. From Contact → Contact Forms, open a form. The plugin adds its own tab next to Form, Mail, Messages and Additional Settings.
2. Paste your EmailOctopus API key and connect. The key is stored once and shared across every ClickSyncr EmailOctopus surface on the site, so other forms and builders reuse the same connection.
3. Choose the EmailOctopus list. The picker lists every list in your account, and the list’s own fields appear below it the moment you choose one.
4. Map your form fields. Email is the required mapping; the rest of the list’s fields load automatically with their types shown.
5. 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.
6. Save the form. That is it: the next submission syncs.

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

Does each Contact Form 7 form need its own EmailOctopus key?

No. ClickSyncr for EmailOctopus stores one API key for the whole site, so every form and every builder shares the same connection. Each form still chooses its own list and field map.

Can different forms feed different EmailOctopus lists?

Yes. Every form carries its own ClickSyncr EmailOctopus setup, so each one picks its own list and mapping.

Other form builders

ClickSyncr for EmailOctopus also connects WPForms · Gravity Forms · Ninja Forms · Fluent 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.

Frequently asked questions

Which Contact Form 7 consent values allow a submission to reach EmailOctopus?

The consent check recognises yes, true, on, checked, and the checked value 1. It rejects empty answers and explicit negatives such as no, false, off, and unchecked. Recognised checkbox types can also use another nonempty value unless it is an explicit negative. Choose the actual consent input in Contact Form 7, then test its checked and unchecked answers.

How does Contact Form 7 send number fields to EmailOctopus?

The integration checks the field type loaded from the selected EmailOctopus list. For a number field, it removes commas and converts a numeric answer to a number. If the remaining value is not numeric, the client sends cleaned text instead; it does not repair the answer. Validate the Contact Form 7 input and check the actual result returned by EmailOctopus.

Why do EmailOctopus sync counts stay unchanged after a Contact Form 7 submission?

ClickSyncr excludes skipped results from both success and failure counts. Missing form credentials, a missing destination, an invalid email, or refused consent can therefore leave the counters unchanged. Check the saved ClickSyncr settings on the Contact Form 7 form you submitted. Then submit a valid test with consent given. A stationary counter alone does not establish whether the contact was sent to EmailOctopus.