Connect iContact to sync your iContact contacts into Avid on a daily schedule. You authorize Avid inside iContact using External Login, then enter your API-specific password and IDs in Avid. Avid cannot use your normal iContact login password or an Application ID you create under Custom API Integrations.
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 are unsure whether to enter an Application ID in iContact or in Avid.
- 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 |
|
| Time | 3–5 minutes |
Do not use Custom API Integrations. If you create an integration under iContact Settings → iContact Integrations → Create, iContact generates its own Application ID for you. Avid does not use that flow. You must use External Login and enter Avid's Application ID instead.
Why you enter Application ID in iContact: Avid is a third-party application registered with iContact. You authorize Avid in your iContact account by entering Avid's Application ID on External Login and creating a password for that authorization.
Avid cannot connect with your normal iContact password. You must create an API-specific password on External Login.
Application ID exception: If LockStep Support emailed you a different Application ID, use that value in iContact External Login even if Avid shows another ID. A mismatched Application ID prevents the connection from saving.
Steps
-
In Avid, go to Settings → Connections. Click Add System, then select iContact.
The page shows Avid's Application ID in the setup instructions. Keep this tab open. You will copy values between iContact and Avid.
-
In a new browser tab, open iContact External Login: https://app.icontact.com/icp/core/externallogin.
Log in with your normal iContact credentials. The External Login page opens.
-
In the Application ID field on External Login, enter the Application ID shown in the Avid iContact connection form.
You are authorizing Avid to access your iContact account. You do not paste an iContact-generated Application ID into Avid.
-
Create a strong password for the external program entry. This is your API-specific password. You will enter the same value in Avid.
You create this password yourself in iContact. iContact does not generate this password for you.
Click Save in iContact. Copy your Account ID and Client Folder ID from the same page.
-
Back in Avid, enter these values in the iContact connection form:
- Username: your full iContact login email address
- API-specific password: the password you just created on External Login
- Account ID
- Client Folder ID
In iContact, the Account ID and Client Folder ID may look the same or appear more than once. Copy each value exactly as shown.
-
Click Save.
Avid calls the iContact API immediately. If all values are correct, the connection saves and shows as active.
What Avid validates during setup
- Avid calls the iContact API using Avid's Application ID plus the username, API-specific password, Account ID, and Client Folder ID 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
-
Verify the connection is active.
In Avid, go to Integrations → iContact and confirm the status shows Active. -
Confirm contacts landed in Avid.
Create a quick test audience that targets the newest iContact contacts. -
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"). -
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 used Custom API Integrations in iContact
Symptoms: credentials look correct, but Avid still cannot connect.
- Confirm you did not create a Custom API Integration under iContact Settings → iContact Integrations.
- Open External Login instead.
- Enter Avid's Application ID from the Avid connection form. Create a new API-specific password and try again.
If you see a credentials error
Avid could not authenticate with iContact.
Error message:
The credentials entered were not able to successfully connect to iContact. Please check your entry and try again.
- Confirm Username is your full iContact login email address, not just the part before
@. - Confirm you used the API-specific password from iContact External Login, not your normal iContact login password.
- Confirm you entered Avid's Application ID on External Login, not an Application ID from Custom API Integrations.
- Create a new API-specific password on External Login and try again.
If you see an Account ID or Client Folder ID error
Avid could not verify your IDs with iContact.
Error message:
Unable to verify the Account ID and Client Folder ID with iContact. Please double-check the values and try again.
- Return to iContact External Login.
- Copy the Account ID and Client Folder ID again.
- Paste them into Avid and click Save.
Tip: Keep your iContact External Login page open while connecting. Most issues are copy/paste errors.
Troubleshooting: credentials look correct but connection still fails
The most common cause is an Application ID mismatch. The API-specific password you create on External Login is tied to the Application ID you enter there.
- Open the Avid iContact connection form and note the Application ID shown in the instructions.
- On iContact External Login, confirm the same Application ID is entered.
- If LockStep Support sent a different Application ID by email, use the emailed value in iContact even if Avid shows another ID.
- Create a new API-specific password on External Login after confirming the Application ID, then try again in Avid.
For agency partners
Avid validates iContact credentials with a GET request to the client folder resource. You can run the same check outside Avid to confirm credentials before opening a support ticket.
Replace the placeholders with values from External Login. Use the same Application ID shown in the Avid connection form.
curl -s -w "\nHTTP Status: %{http_code}\n" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "API-Version: 2.2" \
-H "API-AppId: APPLICATION_ID_FROM_AVID" \
-H "API-Username: FULL_ICONTACT_LOGIN_EMAIL" \
-H "API-Password: API_SPECIFIC_PASSWORD" \
"https://app.icontact.com/icp/a/ACCOUNT_ID/c/CLIENT_FOLDER_ID"
- HTTP 200: credentials and IDs are valid for Avid.
- Non-200: fix credentials or IDs in iContact before escalating to Avid.
iContact documents third-party authorization in their API Getting Started Guide under "Applications Developed by a Third Party."
When to contact LockStep Support
Contact support if the connection still fails after you confirm External Login setup, full login email, and a fresh API-specific password.
Include:
- The exact error message from Avid.
- The time you attempted the connection.
- A screenshot of the Avid iContact connection form (hide passwords).
- A screenshot of iContact External Login showing the Application ID and Account ID / Client Folder ID (hide passwords).
- For agency partners: the HTTP status code from the curl test above (hide passwords).