Skip to main content

Connecting iContact

Updated

Connect iContact to sync your iContact contacts into Avid on a daily schedule. You'll authenticate using an iContact API-specific password (not your normal login password).

Use this article when…

  • You want Avid to sync Contacts from iContact.
  • You see a connection error and need to confirm your iContact IDs and credentials.
  • You need to update an existing iContact connection with new credentials.

Applies to and prerequisites

Applies to Avid Integrations → iContact
Who can do this Users with access to Integrations in Avid
What you need
  • Your iContact login email (username).
  • An iContact API-specific password that you create in iContact External Login (not your normal login password).
  • Your iContact Account ID and Client Folder ID from the same iContact page.
Time 3–5 minutes

Avid cannot connect with your normal iContact password. You must create an API-specific password in iContact.

Application ID may be provided by your Avid team. If LockStep Support provided an Application ID by email, use that value even if Avid shows a different one. A mismatched Application ID can prevent the connection from saving.

Steps

  1. In Avid, go to Settings → Connections and click Add System, then select iContact.

  2. In a new browser tab, open iContact's External Login page: https://app.icontact.com/icp/core/externallogin.
  3. In iContact, enter the Application ID. Use the Application ID provided by LockStep if you received one; otherwise, use the Application ID shown in Avid.

  4. In iContact, create a strong password for the external program entry. This is your API-specific password: you will use this same value in Avid.

    You create this password yourself in iContact. It is not a password that iContact generates for you.

  5. Back in Avid, enter the following values from iContact into the iContact connection form:

    • Username (your iContact login email)
    • API-specific password (the password you just created in iContact)
    • Account ID
    • Client Folder ID

    In iContact, the Account ID and Client Folder ID may appear to be the same value or shown multiple times. This is expected, copy each value from iContact exactly as shown.

  6. Click Save.

What Avid validates during setup

  • Avid immediately calls the iContact API using the credentials and IDs you entered.
  • If any value is incorrect, Avid shows an error and does not save the connection.

What data is synced

  • Contacts only.

Sync timing

  • Avid creates the connection with a daily sync schedule by default.

If you reconnect or update the integration

  • Updating an existing iContact connection updates your credentials and refreshes the underlying data source.
  • If you connect a different iContact account to an existing connection, Avid resets the connection to re-sync from the new account.

What you'll see

  • You have an active iContact integration connection in Avid.
  • Avid is scheduled to sync iContact Contacts daily.

Next steps

  1. Verify the connection is active.
    In Avid, go to Integrations → iContact and confirm the status shows Active.
  2. Confirm contacts landed in Avid.
    Create a quick test audience that targets the newest iContact contacts.
  3. Create an Audience you can reuse.
    In Audiences, save a reusable audience for iContact contacts (for example, “iContact – All Contacts” or “iContact – New This Week”).
  4. Check the first sync results before scaling.
    After the next scheduled sync window, review your audience size and spot-check a few records for expected fields.
Troubleshooting: common connection errors

If you see a credentials error

If you see this message, Avid could not authenticate with iContact:

"The credentials entered were not able to successfully connect to iContact. Please check your entry and try again."

  1. Confirm Username is your iContact login email.
  2. Confirm you used the API-specific password you created in iContact External Login (not your normal iContact login password).
  3. Create a new API-specific password in iContact and try again.

If you see an Account ID or Client Folder ID error

If you see this message, Avid could not verify your IDs with iContact:

"Unable to verify the Account ID and Client Folder ID with iContact. Please double-check the values and try again."

  1. In iContact, return to the External Login page.
  2. Copy the Account ID and Client Folder ID again.
  3. Paste them into Avid and click Save.

Tip: Keep your iContact page open while connecting. Most issues are copy/paste errors.

Troubleshooting: If you used the correct credentials but the connection still fails

If you confirmed your Username, API-specific password, Account ID, and Client Folder ID are correct, the most common cause is an Application ID mismatch.

  1. Confirm whether LockStep Support sent you an updated Application ID.
  2. If they did, use the emailed Application ID in iContact (even if Avid shows a different one).
  3. If the issue persists, contact LockStep Support and ask them to confirm the Application ID is updated in Avid.

What to send: the time of your attempt and screenshots of the Avid integration form (hide passwords) and the iContact external login screen showing the Application ID and IDs (hide passwords).

Get help

If you still cannot connect after verifying your credentials and IDs, contact LockStep Support and include:

  • The exact error message you see in Avid.
  • The time you attempted the connection.
  • A screenshot of the Avid iContact connection form (hide passwords).
  • A screenshot of iContact's External Login page showing your Account ID and Client Folder ID (hide passwords).

Related to

Related articles