Connect Convert Forms with iContact

Are you interested in adding subscribers to your iContact lists through your Joomla forms? Are you seeking a solution to integrate Convert Forms with iContact and automate lead generation effortlessly? With the iContact app for Convert Forms, you can easily subscribe users in your iContact account each time someone submits your form.

This tutorial will guide you through using and configuring the iContact addon in Convert Forms.

Requirements

To use the iContact integration, there are a few requirements you need to meet, listed below:

  • Ensure you are using Convert Forms 4.4.10-RC5+ Pro. You can easily upgrade to Pro if you're currently in the Free version
  • The "Convert Forms - Apps - iContact" plugin is enabled.
  • Your form includes an Email field.

Setting Up iContact Task

To set up the iContact task and sync your submissions to the iContact service, go into your form, and follow the steps listed below:

Select App

From within your form, click on Tasks > CREATE YOUR FIRST TASK.

Create First Task

On the modal that will open, select the iContact task.

Select iContact Task

Select New Submission under Trigger and Add/Update Contact under Action on the next screen, and click CONTINUE.

Select iContact Trigger and Action

Create Connection

A connection is essential to be able to connect to a 3rd-party service, such as iContact. Let's see how to create a new connection that will allow us to connect to iContact.

On the next step, click SIGN IN to start creating our iContact connection.

Sign in iContact Connection

To create our connection with iContact, Click ADD CONNECTION to get started.

Add Connection iContact Task

Where to find the App ID, Username, and Password

Find the App ID and App Password can be done via iContact's Settings which you need to start from.

icontact settings

Once you are in the Settings Menu, click the "iContact Integrations".

icontact new app

On the next page, you will need to click on the "Create" button to create your own integration in order to connect with iContact.

Then you need to type in a distinct name for the App and a Description. The purpose of these are only so you can distinguish the App's purpose and you can type anything you want.

icontact app details

Finally, iContact automatically generates the AppId, Username and Password for your integration.Remember to copy and paste the App ID, Username and App Password back to the iContact Integration in ConvertForms.

Now that we have created our iContact API Key, we can continue setting up the connection with iContact. Enter a connection name and paste your iContact API Key in the fields iContact Name and iContact API Key, respectively. Then click ADD CONNECTION.

Add Connection Form iContact Task

The connection has been added, and you can close the connections window.

New Connection iContact Task

If you see the "Connection added" message, your connection with iContact has been established, and you can continue with the next step. If you see any error message, please review your API Key.

Select the newly created connection from the list and click CONTINUE.

Select Connection iContact Task

Ensure that your newly created iContact connection is selected in the dropdown.

Tip: Connections are reusable across your Tasks; read more on the Working with Tasks documentation page.

Setup Action

After you've set up the trigger, action, and connection, it's time to set up the action itself and define what information to send to iContact. In this step, you can view all available settings and map each option with a fixed or dynamic value using Smart Tags.

Setup Action iContact Task

Let's see all available settings:

List

Select the list to assign the newly created contact to.

Update existing subscriber

Enable to update existing subscribers' information on your iContact account. Disabling this will result in your users seeing an error message when the form is submitted, which prevents already subscribers from re-subscribing to your lists.

Double opt-in

Enable to require the user to confirm their subscription first. The contact will appear in your iContact list with Status = Not Confirmed until they've confirmed they subscription.

Email Address

Select the email address of the contact. This is the user that will be subscribed to your iContact list. Choose the Email field in your form.

First Name

Set the first name of the contact.

Last Name

Set the last name of the contact.

Custom Fields

iContact provides custom fields, which allow you to store additional information when a subscriber is saved on your iContact account, such as their name, age, company info, and more!

Add Conditional Logic

Conditional logic makes it possible to run tasks only if specific criteria are met, like a user’s email address matching a certain domain, the user being associated with a certain Joomla User Group, or a form submission having a specific value.

While editing the iContact task, go to the Setup Action step and scroll down to the Conditional Logic section to set up Conditional Logic. Here's where you define all the rules the task should meet to run.

For example, let's say we need to sync submissions to iContact, only if the email is coming from a specific domain: @domain.com.

  1. Click to enable the Run this task when certain conditions are met.
  2. Click Add Your First Condition.
  3. Select the Email field in the Trigger dropdown.
  4. Select Contains in the Operator dropdown.
  5. Enter @domain.com in the value. Replace this with your domain name.

The condition should look like this:

iContact Task Conditional Logic Example

You can read more on Conditional Logic on the Working with Tasks documentation page.

Activate Task

The final step is to enable our task. To do so, click the toggle on the dialog’s top right corner, as shown in the screenshot below.

Enable Task iContact Task

Finally, click Save to save the task, close the dialog, and then click Save from the top right corner of the form builder to save the changes on the form.

Congratulations! You’ve successfully created a form that syncs new submissions to the iContact email marketing service!

Last updated on Feb 12th 2025 15:02