With our iContact integration, you can add those who submit your forms to your email marketing campaign(s) iContact. Contacts will be added to your campaigns upon submission of the form. If they already exist in iContact, their list selections will be updated.
To add the iContact integration to your form, go to Settings > Integration > Email and click the "Add" button next to iContact.
You will then be automatically directed to the iContact integration settings to set up the integration. If you have already created an API password for Formstack, you can enter it here.
If you haven't created an API password for Formstack, you'll need to follow the steps that appear above the username/password fields. Start by clicking the link in step one: https://app.icontact.com/icp/core/externallogin
You will be directed to iContact to log in.
After you login, you will be directed to the page below to enter the Application ID that can be found in the iContact integration settings in Formstack. If you are not directed to that page, click on the URL above and it will take you there.
Paste the Formstack App ID (ex: YuUkJ4pwtbyIwUD2bpvauSzEykrzVoLJ) into the Application ID box in iContact by clicking on the security lock icon to the right of the Application ID. Then, create a password (make it different than your iContact password). Make sure you click Save.
After you have done this, enter your username and the new password you just created into the username and password fields in the iContact integration settings in Formstack and click the Login to iContact button.
After doing so, Contact fields and your List Assignments will populate. These are default fields defined by iContact and there is not a way to pass other custom field data at this time. Map the appropriate Contact fields from your form to fields in iContact. All mapped fields will pass along submitted form data to the matching fields in iContact when the form is submitted.
To hard-set the list(s) that end-users are added to, select "I will select which lists contacts get assigned" in the List Mode field and check the box next to each list you want to subscribe your contact to. If you need to refresh your lists, click the green refresh button in the right corner of the List Assignment section. You will need to do this every time you make any changes to lists in your iContact account otherwise, the integration will break on your form in Formstack and those who submit your form, will not be added to iContact.
If you would like to allow those submitting your form to select which lists they are added to, you can do this by selecting the option to "Allow the lists to be selected on the form".
You will need to create a corresponding field on your form that allows submitters to choose a list or lists. You can use a Select List field, Radio Button field, or a Checkbox field for this. You will need to add the email list options just as they appear in Constant Contact or it will NOT work properly.
You will then need to map this field from your form to the "List Field" in the integration settings as shown above.
Once you have mapped all appropriated fields, make sure you toggle the integration "on" via the on/off switch in the top right corner of the integration settings.
Re-Running the Integration
If an integration fails upon submission, check your integration settings for errors in API or login credentials or in the mapping of form fields. Then, click on a submission in your database. You will see ‘Integration Status’ on the left side of the submission. Click "Run Again". The integration will begin running. If it is successful, a green "Success" message will appear. If it is not, a red "Failed” message will be shown. If this happens, go back to your integration settings and check for other errors in setup.