Tassos Marinos Developer of Joomla Extensions

How to connect Convert Forms with iContact

Published in Convert Forms
Updated 29 Nov, 2019

Convert Forms offers seamless integration with iContact email marketing service. Connecting Convert Forms to your iContact email list is very easy. Follow our step by step guide on how to connect Convert Forms with iContact.


1. Addon Installation

  • Navigate to Components > Convert Forms > Addons
  • Click the Cog button for the iContact Addon. A popup will appear where you can enable the addon.

icontact convert forms addon

  • Click on the Status and select Enabled.
  • Now you can click on Save & Close button to save the enabled addon.

convert forms update plugin status

2. Campaign Setup

To setup a Campaign with iContact, follow the steps below.

icontact campaign convert forms

  • Navigate to Components > Convert Forms > Campaigns
  • Create a new Campaign by clicking New
  • Type a name for your Campaign. This name can not be seen by anyone else but you.
  • For the Sync Leads > Choose Service selectbox choose iContact. If you can not find the iContact option then you do not have the iContact Addon installed and activated. In that case, please go back to the top of the article and see how to install the mandatory addon.
  • Save the Campaign for the special iContact fields to show up.
  • iContact needs:
    • App ID
    • Username: This the username/email you use to login to iContact.
    • App Password
    • A List ID: Once you click the "Lists" button, a dropdown of your available Lists will appear and you can select the List you are interested in populating. Make sure that all the fields above have been filled out first before selecting your List.
  • Click Save & Close

Where to find the App ID and App 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.

3. Fields

For a Convert Form to successfully store an email address to your iContact account it needs to have an email field. This field is already set up at the time of creating the form and you don't have to change its input value as it is already configured for you.

icontact convert forms email field

iContact offers this basic set of Contact Fields that you can use as it is displayed in the screenshot below.

  • prefix
  • firstName
  • lastName
  • suffix
  • street
  • street2
  • city
  • state
  • postalCode
  • phone
  • fax
  • business

icontact convert forms first name field

icontact convert forms last name field

As an example, we used the fields firstName and lastName from the list and added them to our ConvertForm.

4. Assign form to Campaign

Of course don't forget to assign the form to our newly created Campaign! See the screenshot below to understand where to assign it.

icontact convert forms assign