Overview

Constant Contact is an email and digital marketing platform used by organizations to manage contact lists, send email campaigns, and engage audiences across channels.

Common uses for the Alchemer Constant Contact integration

• Personalize invites and surveys using Constant Contact contact details
• Automatically create or update Constant Contact contacts when a response is submitted
• Add survey respondents to a selected Constant Contact contact list
• Write survey answers back to Constant Contact custom fields
• Reduce manual data entry and contact list maintenance

What can the Alchemer Constant Contact integration do?

• Get contact details
• Upsert contact

You will need

• Constant Contact OAuth authentication (sign in with your Constant Contact account). More details in the authentication how-to guide.
• An Alchemer plan that includes integrations with the Integration Manager permission enabled.
  • Contact us if you are unsure if your plan includes integrations.

Setup Alchemer Constant Contact integration in surveys

Constant Contact | Get Contact Details

You will need:

• Constant Contact login credentials. More details in the authentication how-to guide.
• A survey field containing the Constant Contact contact_id of the contact you want to retrieve

Configure the action

1. Open your survey in Survey Builder.
2. Select Add New: Action.
3. In the Add Action modal, scroll to the Your Integrations section.
4. Select Constant Contact.
5. Select Constant Contact | Get contact details.
6. Constant Contact | Authentication: Select an existing authentication or create a new one.
7. Constant Contact | Contact ID: Select the Alchemer survey field that contains the contact_id of the contact you want to find in Constant Contact.
   1. Data prep options: Choose how input values are prepared before they are sent (e.g., Strip HTML tags from inputs).
8. Constant Contact | Get data back: Map the Constant Contact contact fields you want returned (e.g., email address, first name, last name, custom fields) to the Alchemer survey fields you want to update. These values can personalize survey questions or drive logic.
9. Save the action.

Status codes

• 200: Successfully found contact
• 404: Contact not found
• 400: Failed to get contact

Constant Contact | Upsert Contact

You will need:

• Constant Contact login credentials. More details in the authentication how-to guide.
• A survey field containing the contact's email address
• The name of the Constant Contact contact list the contact should be added to or updated on

Configure the action

1. Open your survey in Survey Builder.
2. Select Add New: Action.
3. In the Add Action modal, scroll to the Your Integrations section.
4. Select Constant Contact.
5. Select Constant Contact | Upsert contact.
6. Constant Contact | Authentication: Select an existing authentication or create a new one.
7. Constant Contact | Contact list: Select the contact list the contact is already associated with, or that you would like them to be associated with, and confirm your selection.
   1. Data prep options: Choose how input values are prepared before they are sent (e.g., Strip HTML tags from inputs).
8. Constant Contact | Upsert contact: Map Alchemer survey fields to the Constant Contact contact fields you want to create or update.
   1. Note: Email must be mapped. Constant Contact matches existing contacts on email address — if a contact with that email exists, it is updated; otherwise, a new contact is created.
   2. Note: Constant Contact custom fields support text and date values only. Please reference Constant Contact's API documentation to ensure inputs match required formatting.
9. Constant Contact | Get data back: Select metadata fields (message, status code) to return. These help with debugging your integration.
10. Save the action.

Status codes

• 201: Successfully created contact. Contact added to the selected list.
• 200: Successfully updated contact. Contact added to the selected list.
• 400: Failed to upsert contact

Testing and Troubleshooting

Testing and Validation

How to test

• Submit a survey response with data that triggers the integration action.
• Confirm the expected contact activity in Constant Contact (retrieved, created, or updated).
• Use returned metadata to validate successful behavior.

How to verify results

• Inspect the affected contact and contact list in Constant Contact.
• Ensure all retrieved or updated values match expectations.

Monitoring Integration Activity

Where to find logs

• Go to Results → Individual Responses.
• Select the response you want to inspect.
• Open the Action Log tab.

What logs display

• Success or failure status
• Timestamp
• Input and output values
• Returned status codes from Constant Contact

Troubleshooting

Authentication issues

• Expired or revoked Constant Contact OAuth session
• Constant Contact user lacks permission to view or edit contacts

Lookup failures

• Invalid or missing contact_id
• No matching contact found in Constant Contact

Mapping errors

• Email address not mapped on Upsert contact
• Invalid email address format
• Incorrect custom field formatting (custom fields accept text or date values only)

API errors

• Constant Contact validation failures
• Rate limits or account custom field limits reached

FAQs

What permissions do I need?
Integration Manager in Alchemer and a Constant Contact account with access to the contacts and contact lists you want to use.

When does the integration run?
In real time when a survey response is submitted.

Can I use multiple Constant Contact actions in one survey?
Yes. Actions can run independently or in sequence.

How does Upsert contact decide whether to create or update?
Contacts are matched on email address. If a contact with the mapped email already exists, it is updated and added to the selected list; otherwise, a new contact is created.

Why isn’t my data updating?
Check the Action Log for lookup issues, mapping mismatches, or API errors.

What if I need additional functionality?
Contact Alchemer Support for enhancement requests.