🎉 Celebrate with 10% OFF on All Products! Use Code: GFEX10 Or Buy Any 2+ Items for 30% OFF with Code: GFEX30!
Guides & Tutorials October 24, 2026

How to Send Gravity Forms Submissions to an EmailOctopus List With Tags and Custom Fields

GravityExtra
How to Send Gravity Forms Submissions to an EmailOctopus List With Tags and Custom Fields

A newsletter sign-up form is only worth something if every address it collects ends up in the right list, with the right tags, on the day it was typed in. Many sites still depend on a manual export, a middleman service that charges by the task, or an embedded form from the email tool that does not match the site. If you use Gravity Forms and EmailOctopus there is a simpler way: keep your own form and send each submission straight to your EmailOctopus list, with the tags and the custom fields you choose. This guide shows how, step by step, using the Gravity Forms EmailOctopus Premium Add-on and your own API key.

Why send the form straight to the list

The first reason is design. A form built in Gravity Forms matches your site, uses your fields, shows your validation messages and sends people to your own thank you page. The second is data. Your form can ask for a first name, a company, an interest or a birthday, and each of those can fill a custom field of the list, so your emails can be personal from the first message. The third is segmentation. A tag set at the moment of sign-up tells EmailOctopus which offer the person came for, which page they were on, or which box they ticked.

Without a direct connection, somebody exports a spreadsheet and imports it again, or a middleman service sits between the form and the list. Both add delay and cost, and both are one more place where a name or an address can be lost. A direct connection removes them. The visitor submits the form, the contact lands in the list, and you see the result as a note on the entry.

What you need before you start

  • Gravity Forms 2.9 or newer, and a form with at least an email field. A Name field with first and last parts is useful.
  • An EmailOctopus account with a list. Create the custom fields you want, such as Company or Interests, in the list first.
  • An EmailOctopus API key. You create it yourself in your account.
  • A line on the form that tells people their details go to your email list, with a consent box where your country requires one.

Step 1: create an API key

In EmailOctopus open the integrations and API page and create a key. Copy it once. The add-on uses version 2 of the EmailOctopus API, so a key made for the old version has to be created again. The key belongs to your account, nothing is shared with anybody else, and the add-on sends it only to the EmailOctopus API address over a secure connection.

Install the add-on, open Forms → Settings → EmailOctopus, activate your license and paste the key. The key is encrypted before it is saved and is never shown again, so a database backup does not hold it in clear text. When you save, the connection line tells you whether EmailOctopus accepted it and how many lists it found.

The EmailOctopus settings screen in Gravity Forms: the license box and the EmailOctopus account section with an encrypted API key field and the connection status showing two lists found
The add-on settings: your own API key, stored encrypted, and the connection status.

Step 2: build the form

Keep the form short. A name and an email are enough for most newsletters, and every extra field costs sign-ups. Add what you will really use. If you want to personalise by interest, a set of checkboxes works well, because the add-on turns the ticked boxes into the choices of a multiple choice field. If you want to segment by source, a hidden field that holds the page or the campaign name can become a tag.

Step 3: add the feed

Open the form and go to Settings → EmailOctopus, then press Add New. Name the feed, and pick your list from the drop-down. The lists are read from your account, so you choose by name, not by a long id.

Next, choose the subscription status. Leave it on List default for a form that is not only a sign-up: a new contact gets what the list does, and someone who unsubscribed earlier is not subscribed again behind their back. Choose Subscribed for a clear newsletter form. Choose Pending if your list uses double opt-in and you want EmailOctopus to send the confirmation email.

Step 4: map the fields

Choose the form field that holds the email, and the fields for the first and last name. Then use the custom fields table for everything else. In the left column write the tag of the list field, in the right column choose the form field. A few examples show how it works.

  • A Company field in the form fills the Company field of the list.
  • A Birthday field fills a date field. The add-on writes the date in the form EmailOctopus expects, and leaves the field out if the text is not a date.
  • A number such as the number of employees fills a number field as a real number, and words in that box are left out instead of making the call fail.
  • A set of checkboxes fills a multiple choice field with the ticked choices.

Because the add-on reads the field types of your list, you do not have to think about these formats. If a value does not fit, only that value is skipped and the contact is still subscribed.

The EmailOctopus feed editor: the list, the subscription status, the mapped email and name fields, custom fields, tags to add and remove, and conditional logic
A feed: which list and status, which form fields fill the contact, which tags, and the condition.

Step 5: add and remove tags

Tags are where the real value is. In the Add tags box, type the tag names separated by commas, for example website, spring-offer. Merge tags work too, so a drop-down called Plan can add the tag that matches the choice. In the Remove tags box, type the tags that should disappear when the form is sent. A typical use is a lead tag that comes off when someone becomes a customer, while the customer tag goes on.

Only the tags you name are changed. Everything else that the contact already has stays as it is, which is exactly what you want when the same person fills in several forms over time.

A few ideas show how far tags can go. Tag people by the page they signed up on, so a welcome email can mention the right topic. Tag people by the offer they chose, so the first campaign matches what they asked for. Tag people who ticked an interest box, and send them only that content later. Use one more tag for the form itself, such as footer-form or checkout-form, to learn which placement brings the most sign-ups. Because tags are plain words, you can start with a few and add more as your plans grow, without changing anything in the list.

Step 6: send only the right people

Turn on conditional logic when only some entries should be sent. A common case is a single contact form with a checkbox that says Send me your newsletter. The feed runs only when the box is ticked. Another case is one form with two feeds, a newsletter list and a customer list, each with a condition based on the choice of a drop-down.

Test it

  1. Submit the form with a test address that you own.
  2. Open the entry in Gravity Forms. The note shows the list and the number of tags added, with the email masked.
  3. Open the contact in EmailOctopus and check the fields and tags.
  4. Submit again with the same address and a different tag, and check that the contact was updated and not duplicated.
A Gravity Forms entry screen with a note that says the contact was sent to an EmailOctopus list, with a masked email and the number of tags added
Every submission is written to the entry as a note, with the email masked.

What happens when something goes wrong

The visitor never sees an error. The form is saved, the confirmation is shown, and a note on the entry explains what went wrong, with the status and the first message from EmailOctopus. A 401 means the key was not accepted. A 404 means the list is not in that account. A 422 means EmailOctopus refused the data, and the note names the field. The add-on does not retry on its own, so you decide what to do with that lead. A contact that was sent successfully is marked on the entry, so running the feed again never sends it twice.

Good habits for email sign-ups

  • Tell people what they will receive and how often, next to the button.
  • Use double opt-in where your country or your list requires proof of consent.
  • Keep tag names short and consistent, in lower case, so that segments stay easy to read.
  • Do not subscribe people who only asked a question through a contact form. Use a checkbox and a condition.
  • Review your tags every few months and remove the ones that no longer mean anything.

Questions people ask

Do I need a paid EmailOctopus plan?

The add-on needs API access to your account, and your own plan and its limits apply as usual.

Does it create the custom fields in my list?

No. Create the fields in EmailOctopus first and use their tags in the add-on. This keeps your list under your control.

Will it unsubscribe anyone?

No. It never sends the unsubscribed status. With the List default status, someone who unsubscribed stays unsubscribed.

Which Gravity Forms versions does it support?

Gravity Forms 2.9 and newer. It is tested with Gravity Forms 3.1.2 on PHP 8.3 and Gravity Forms 2.9.8 on PHP 7.4.

Get started

The Gravity Forms EmailOctopus Premium Add-on sends the people who fill in your Gravity Forms form to your EmailOctopus list with your own key, with custom fields, tags, a clear status and a note on every entry. See the features, the price and the setup guide on the add-on page.

See the EmailOctopus add-on

0
0
Your Cart
Your cart is emptyReturn to Shop
🔥 FREQUENTLY BOUGHT TOGETHER
Complete Combo & Save 40%!
ITEM IN YOUR CART
Gravity Forms Klaviyo Add-on
$39.00/yr
+
🎁 RECOMMENDED ADD-ON SAVE 40% OFF
Original Price: $39.00/yr
Bundle Special Price: $23.40/yr