🎉 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 Subscribe Contacts to Zoho Campaigns From Gravity Forms

GravityExtra
How to Subscribe Contacts to Zoho Campaigns From Gravity Forms

Every website that collects email addresses has the same quiet problem: the address arrives in a form entry, and somebody has to copy it into the email marketing tool. Sooner or later nobody does, the list stops growing, and the newsletter goes out to the people who were already there. If your newsletters live in Zoho Campaigns, the cure is to let the form add the subscriber by itself. This guide shows how to subscribe contacts to Zoho Campaigns lists and topics from Gravity Forms, with custom fields, using your own Zoho client.

What a good form-to-list setup does

  • It adds the contact to the right mailing list the moment the form is sent, with no copying and no export file.
  • It fills the contact fields that matter, not only the email address: the name, the company, the plan, anything you created as a custom field in Zoho Campaigns.
  • It respects consent: only people who ticked the box are subscribed, and the confirmation rules of your Zoho list still apply.
  • It handles repeat visitors without errors, so an existing subscriber does not make a failed entry.
  • It keeps your Zoho keys safe, and it never stops the form from working when Zoho is slow.

The Gravity Forms Zoho Campaigns Premium Add-on does these things, on your own server, with your own Zoho OAuth client. Here is how to set it up, step by step.

Step 1: create a client in the Zoho API Console

Zoho does not hand out a shared key. You create a client for your own account, and that is good: nobody else can use it, and you can revoke it at any time. Sign in to the API Console of the data centre where your Zoho account lives. That is the Zoho address you use every day: zoho.com for the United States, zoho.eu for Europe, zoho.in for India, zoho.com.au for Australia, zoho.jp for Japan, zohocloud.ca for Canada.

Choose Add Client. Two kinds fit a website. A Self Client gives you a client ID and a secret and lets you generate a one-time code by hand, which is the quickest way and perfect for one site. A Server-based client adds a redirect address and lets you sign in with Zoho from the plugin settings, which is nicer if you connect often or hand the site to somebody else. The add-on supports both.

The Zoho Campaigns connection settings in Gravity Forms: data centre, client type, client ID, client secret and Self Client code
Forms, Settings, Zoho Campaigns: your own Zoho client and the data centre.

Step 2: connect it in Gravity Forms

Open Forms, Settings, Zoho Campaigns. Pick the data centre and paste the client ID and the secret. For a Self Client, go back to the console, generate a code with the scope ZohoCampaigns.contact.ALL and a time of ten minutes, and paste it into the add-on. Press save. The add-on trades the code for a refresh token, reads your mailing lists and tells you how many it found.

Two details matter here. First, the code works once, so if you see an invalid code message, just generate a new one. Second, the secret and the tokens are encrypted in the database. They are never printed back into the page, and the settings screen shows only a mask. If someone gets a copy of your database, they get unreadable text, not the keys to your email marketing account.

Step 3: choose the list and the topics

Open the form you want, go to its settings, choose Zoho Campaigns and add a feed. The mailing lists come straight from your Zoho Campaigns account, so there is no list key to look up and nothing to type. If you use topics, they appear as check boxes under the list.

The Zoho Campaigns feed settings: mailing list, topics, source name, standard contact fields, custom fields and the condition
The feed: the list and topics from your Zoho Campaigns, the contact fields and the condition.

Topics deserve a word. A topic is a subject people can subscribe to, such as a weekly digest or product news, on top of the main list. When you tick topics in a feed, the add-on subscribes the contact through each of them, one request per topic. When you tick none, the contact simply joins the list. Because the list and the topics are chosen per feed, one form can feed a general newsletter and, with a second feed and a condition, a more specific stream.

Name, email and the source

Map the email field and the name parts. If your form asks for a full name in one field, map that field to both the first name and the last name, and the add-on splits it at the last space, so Mary Ann Smith becomes Mary Ann and Smith. The source name is the label Zoho Campaigns keeps for where the contact came from. The default is Gravity Forms, and you can change it per feed, for example to the name of a landing page or a campaign.

Step 4: custom fields

The email address is rarely the only thing you want to know. A company name lets you write to a business differently from a private person. A team size, an interest or a country lets you segment the next campaign. In Zoho Campaigns you create these as custom contact fields. In the feed, the Custom fields section lists them, read live from your own account, next to a value you choose: a form field, or free text with merge tags such as the form title.

Each row sets one field. A field you did not create in Zoho is simply not in the drop-down, but you can type its name exactly as Zoho shows it. The add-on cleans the names and the values before it sends them, drops empty values so that an unanswered question never erases what Zoho already knows, and never lets a custom row overwrite the email address that you mapped.

Step 5: consent and confirmation

Email marketing runs on permission. Add a check box to the form, for example one that says yes, send me news, and set it as the feed condition: subscribe only when that box is ticked. Visitors who leave it empty still send the form, and nothing goes to Zoho. That is cleaner than subscribing everybody and relying on an unsubscribe link later.

On the Zoho side, a mailing list with a signup form enabled sends a confirmation email and adds the contact only after the contact confirms, which is the double opt-in many countries expect. A list without a signup form adds the contact straight away. The add-on follows whatever your list does, and writes the answer of Zoho on the entry so that you can see which one happened.

What your team sees, and what you see

In Zoho Campaigns, the contact appears in the list with the name and the custom fields, marked with your source, and in the topics you ticked. On your side, in WordPress, every entry gets a note that says who was subscribed, to the list or to which topic, and what Zoho answered. If something goes wrong, the note says what Zoho answered, with the error code and message, so you can fix it without guessing.

A Gravity Forms entry screen with the note the add-on wrote: the contact subscribed to a Zoho Campaigns topic
On every entry: who was subscribed, to which list or topic, and what Zoho answered.

The add-on remembers which requests worked. If the feeds run again for the same entry, for example when you re-run them from the entry screen, only the missing requests are sent. And a contact that is already in the list is not an error: Zoho answers with a code the add-on understands, and the note says that the contact was already there.

More than one list, more than one form

You can add several feeds to one form. A visitor who ticks a box about events can go to an events list, while everybody who consents goes to the main newsletter. Or give every form its own feed: the footer signup, the checkout page and the contact form can each feed a different list with a different source name, which later shows you in Zoho Campaigns which form brought which subscribers.

Security and privacy

  • Your Zoho keys stay on your server, encrypted with AES-256-GCM.
  • All calls go from your server to Zoho over HTTPS with certificate checks on. GravityExtra is never in the middle.
  • Only the data you map goes to Zoho. Nothing else from the entry is sent, and the email address travels in the request body, never in a web address.
  • The settings screen never shows the secret, and saving the screen does not overwrite it.
  • You can revoke the client in the Zoho API Console at any time, and the add-on stops working at once.

Common problems

  • The list drop-down is empty: check the data centre, and read the message under the field.
  • Invalid code: the Self Client code is single use and expires. Create a new one.
  • A custom field stays empty in Zoho: the field name must match the one in Zoho Campaigns exactly, so pick it from the drop-down.
  • No subscription for one entry: the email field was empty or the consent condition was not met. The note on the entry tells which.

Frequently asked questions

Does this work with the Canada, Japan, India and Australia data centres?

Yes. Choose the data centre of your Zoho account in the settings. The add-on then uses the matching Zoho accounts and Zoho Campaigns addresses. The United States and Europe work the same way.

Do I need a separate connector service?

No. The add-on calls the Zoho Campaigns API itself, so there is no extra subscription and no third party that sees your subscribers.

Will it slow down my form?

The calls to Zoho are made when the form is sent, on your server, in a few hundred milliseconds in normal use. If Zoho is slow, the timeouts are short and the entry is still saved.

Can I fill custom fields?

Yes. Pick them from the list of your own contact fields, or type the name, and give each one a form field or text with merge tags.

Which Gravity Forms versions are supported?

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 Zoho Campaigns Premium Add-on subscribes contacts to your Zoho Campaigns lists and topics from any Gravity Forms form, with custom fields, your own Zoho client and any Zoho data centre. See the features, the price and the setup guide on the add-on page.

See the Zoho Campaigns 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