AFI
iContact
iContact is an email marketing platform. AFI creates contacts and subscribes them to iContact lists via the iContact API v2.2, authenticating with App ID, API Username, and API Password headers.
What you’ll need
- An active iContact account.
- An App ID, API Username, and API Password from iContact.
- The Advanced Form Integration plugin installed and activated.
Save your iContact credentials
- In iContact, go to Settings → iContact Integrations → Custom API Integrations → Create to get your App ID and API credentials.
- In WordPress, go to AFI → Settings → iContact.
- Enter the App ID, API Username, and API Password.
- Click Save. AFI will automatically fetch your Account ID and Client Folder ID from iContact.
Create the integration
- Go to AFI → Add New.
- Give the integration a name.
- Under Trigger, pick your form plugin and form.
- Under Action → Platform, select iContact.
- In Task, choose Add Contact.
- Select the saved iContact account and a mailing list.
- Map form fields.
- Click Save Integration.
Tasks supported
Add Contact
Creates or updates a contact via POST /contacts/ with status normal, then subscribes the contact to the selected list via POST /subscriptions/.
| Field | Field key | Required | Notes |
|---|---|---|---|
email |
Yes | Must be a valid email | |
| First Name | firstName |
No | |
| Last Name | lastName |
No | |
| Street | street |
No | |
| Street2 | street2 |
No | |
| City | city |
No | |
| State | state |
No | |
| Postal Code | postalCode |
No | |
| Phone | phone |
No | |
| Fax | fax |
No |
The free version supports standard fields. iContact [PRO] adds custom field mapping, unsubscribe, and update contact tasks.
Pro features
| Feature | Free | Pro |
|---|---|---|
| Add Contact | ✅ | ✅ |
| Standard fields | ✅ | ✅ |
| Custom fields | No | ✅ |
| Unsubscribe from List | No | ✅ |
| Update Contact | No | ✅ |
Troubleshooting
“Unable to retrieve account ID”
Verify your App ID, API Username, and API Password are correct. The credentials must have access to the iContact API.