Constant ContactImproved in 3.1.4+
This guide assumes you have a Constant Contact account already.
Compatibility
Uses OAuth flow on v3
of the REST API.
Endpoints
Maps data to the following endpoints:
- Contact Lists
Does your project require something else? Contact Us
Fields
Maps data to the following field types:
- Standard
Setup Instructions
1
Prepare your site's end for Integration
- Go to the Mailing Lists section in Freeform Settings (Freeform → Settings → Mailing Lists).
- Click the New Integration button at the top right.
- Select Constant Contact (v3) from the Service Provider select dropdown.
- Enter a name and handle for the integration.
- Copy the URL in the OAuth 2.0 Return URI field to your clipboard.
- Leave this page open.
2
Prepare Constant Contact's end for Integration
- Open up a new browser tab and go to Constant Contact's API My Applications website.
- Log into your Constant Contact account there.
- Go to the My Applications page.
- Click on the New Application button at top right.
- In the modal window that pops up, enter a name for the application.
- Leave the other 2 settings as they are defaulted.
- Click the Create button.
- Once saved, it'll display a list of your applications.
- For the application you just created, click on the Edit button.
- In the Constant Contact Redirect URI field, click on the pencil icon at the right to edit the value.
- Paste the value you copied from Freeform's OAuth 2.0 Return URI field.
- Click the Confirm button.
- Click the Save button at the top right.
- On the Details page of your application, copy the
API Key
value. - Click the Generate Client Secret button beside the API Key field.
- On the confirm screen that loads, click the Generate Client Secret button.
- Copy the newly created Application Secret value from Constant Contact.
3
Prepare the Connection
- Go back to your ExpressionEngine/Freeform browser tab.
- Paste the
API Key
value from Constant Contact into the the Client ID field in Freeform. - Paste the
Application Secret
value from Constant Contact into the the Client Secret field in Freeform.
4
Finish the Connection
- Click the Save button.
- You will be returned to the integration settings page and the Is Authorized? section will say
Not authorized yet.
- Click on the
Click here to authorize
link. - You will be redirected to a Constant Contact OAuth page to allow permissions.
- If not currently logged in, fill in your credentials.
- Click Allow Access when asked for permissions.
- You will then be redirected back to the Freeform Mailing List Integration page.
- Confirm that there is a green circle with Authorized in the middle of the page.
5
Configure the Form
To use this integration on your form(s), you'll need to configure each form individually.
- Visit the form inside the form builder.
- At the bottom left corner of the builder, click and drag on your Constant Contact special field under the Mailing Lists section into your form layout.
- Click on the Constant Contact special mailing list field inside the form layout.
- On the right side of the page:
- Select a mailing list that new users should be subscribed to.
- Choose a Freeform field to be the target opt-in field.
- Map Freeform fields to the Constant Contact fields as you wish.