Skip to main content
Constant Contact logo
  • Category: marketing
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 93
  • Triggers: 0
  • Slug: CONSTANT_CONTACT
  • Version: 20261101_00

Tools

Slug: CONSTANT_CONTACT_ADD_ACCOUNT_EMAIL_ADDRESSAdd a new email address to a Constant Contact account. Use this action when you need to associate an additional email address with a Constant Contact account. After adding an email address, Constant Contact sends a confirmation email to the new address. You can only use email addresses with CONFIRMED status to create email campaigns. Requires the ‘account_update’ OAuth scope.

Input Parameters

string
required
The new email address you want to add to a Constant Contact account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_ADD_CONTACT_TAGGINGSAdd Tags to Contacts. Use this action when you need to asynchronously add one or more tags to contacts that meet your specified contact filtering criteria. The action creates an asynchronous activity that processes the tag addition. The activity returns an activity_id that can be used to track the status of the operation.

Input Parameters

object
required
Select the source used to identify contacts to which a tag is added or removed. Source types are mutually exclusive.
object
Contacts to exclude from the tag operation.
array
required
An array of tags (tag_id) to add to all contacts meeting the specified source criteria.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_ADD_LIST_MEMBERSHIPSAdd Contacts to Lists creates an activity to add contacts to one or more contact lists. Use this action when you need to bulk-add contacts to Constant Contact lists. The action supports adding contacts by individual contact IDs, all active contacts, contacts from existing lists, segments, engagement levels, or tags. Up to 50 lists and 500 contacts can be specified per request. This is an asynchronous operation that returns an activity ID for tracking progress.

Input Parameters

object
required
The source object specifies which contacts you are adding to your targeted lists.
object
Contacts to exclude from being added to the target list.
array
required
Specifies which lists (up to 50) you are adding your source contacts to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_COPY_EVENTPOST (copy) an existing event in Constant Contact. Use this action when you need to duplicate an existing event to create a new event with similar configuration. The copied event will have a new event_id but will retain all settings, campaigns, and configurations from the source event. You must provide a unique name for the new event. Optionally, you can specify which campaign activities to copy (if not specified, all activities are copied). This action is useful for recurring events or when creating event series with similar configurations. Note: The new event name must be unique within the account.

Input Parameters

string
required
The unique ID of the event to copy. This is a UUID string.
string
required
The name for the copied event. Must be unique for the account.
array
Optional array of campaign activity UUIDs to copy. If not provided, all activities are copied.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_COUNT_CONTACT_CONSENTSGET contact consent counts for a Constant Contact account. Use this action when you need to retrieve aggregate counts of contacts by consent status, including explicitly confirmed, implicitly confirmed, pending, unsubscribed, and total contacts. Optionally include counts of newly subscribed contacts from the last 30 days by specifying the include parameter with ‘new_subscriber’. This is a read-only operation that returns summary statistics about contact consent states.

Input Parameters

string ("new_subscriber")
Valid values for the include parameter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_CONTACTCreate a new contact in Constant Contact with a unique email address, optionally including name, phone numbers, addresses, and list or tag assignments. The action declares the contact_data OAuth scope.

Input Parameters

array
List of tag IDs to apply to the contact.
array
List of list IDs to add the contact to.
string
The contact’s job title.
string
The contact’s last name.
string
The contact’s first name.
string
The contact’s company name.
string
The source where the contact was created. Values: ‘Contact’ (manually created), ‘API’ (created via API), ‘Import’ (bulk import), ‘Survey’ (from survey).
array
List of custom field key-value pairs. Example: [{‘custom_field_id’: ‘cf1’, ‘value’: ‘vip’}]
object
required
The contact’s email address object. Required and must be unique within the account.
array
List of phone numbers associated with the contact.
array
List of street addresses associated with the contact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_CONTACT_FROM_SIGN_UP_FORMCreate or update a contact through a sign-up form submission, matching by email address. Requires an email address and at least one list membership; optional SMS channel details can also be supplied.

Input Parameters

string
The job title of the contact.
string
The last name of the contact.
string
The first name of the contact.
string
The anniversary date for the contact. Valid date formats are MM/DD/YYYY, M/D/YYYY, YYYY/MM/DD, YYYY/M/D, YYYY-MM-DD, YYYY-M-D, M-D-YYYY, or M-DD-YYYY.
object
The contact’s SMS details.
integer
The day value for the contact’s birthday. Valid values are from 1 through 31. The birthday_day property is required if you use birthday_month.
string
The name of the company where the contact works.
string
The phone number for the contact.
array
The custom fields you want to add to the contact as an array of up to 50 custom field objects.
string
required
The email address for the contact. This method identifies each unique contact using their email address. If the email address exists in the account, this method updates the contact. If the email address is new, this method creates a new contact.
integer
The month value for the contact’s birthday. Valid values are from 1 through 12. The birthday_month property is required if you use birthday_day.
object
The street address for the contact.
array
required
The contact lists you want to add the contact to as an array of up to 50 contact list_id values. You must include at least one list_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_CONTACT_LISTCreate a new contact list in Constant Contact. Use this action when you need to create a new contact list to organize and manage your contacts. The list name must be unique within your account. You can optionally provide a description and mark the list as a favorite. Once created, contacts can be added to the list using the appropriate action.

Input Parameters

string
required
The contact list name. Must be unique and is required. Maximum 255 characters.
boolean
Boolean flag indicating whether the contact list is marked as a favorite.
string
A description of the contact list. Maximum 255 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_CONTACT_TAGPOST (Create) a Tag. Use this action when you need to create a new contact tag in Constant Contact. Tag names must be unique within the account. Attempting to create a tag with a duplicate name will result in an error.

Input Parameters

string
required
The name of the tag. Tag names must be unique within the account.
integer
The source of the tag. For example, 2 typically indicates a user-created tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_CUSTOM_FIELDCreate a new custom field for contacts in Constant Contact. Use when you need to add a custom data field to store additional information about contacts, such as preferences, custom attributes, or extended contact details. The custom field can store different types of data including strings, numbers, dates, currency values, and select options. Required fields are ‘label’ (the display name) and ‘type’ (the data type to store).

Input Parameters

string
required
The type of data to store in the custom field.
string
required
The custom field name to display in the UI (free-form text).
array
Array of choices for custom fields of type ‘single_select’ or ‘multi_select’. Maximum number of elements for ‘checkbox’ and ‘radio’ display types is 20. Maximum number of elements for a ‘dropdown’ is 100.
integer
Available if data type is ‘date’. Displays ‘1’ if using legacy date fields where values are stored as strings. Displays ‘2’ if using new date fields where values are stored as actual dates.
object
Additional metadata options for custom fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_EMAIL_CAMPAIGNCreate a new email campaign in Constant Contact. Use this action when you need to create a new email marketing campaign. The campaign will be created in DRAFT status by default. You must include a unique name for the campaign and at least one email campaign activity containing the email content (from_email, from_name, reply_to_email, subject, and html_content). After creation, the campaign can be scheduled or sent using appropriate actions. This action is suitable for creating marketing campaigns, newsletters, or promotional emails. Note: You must validate your sending email address in Constant Contact before you can use it in a campaign. Include [[trackingImage]] in your HTML content for open tracking.

Input Parameters

string
required
The name of the email campaign. Must be unique within the account. Maximum 255 characters.
array
required
Array of email campaign activities. At least one activity is required.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_EVENTCreate a new event with default settings in Constant Contact. Use this action when you need to create a new event in Constant Contact. The event is created with default settings including a registration form and landing page. The event will be created in DRAFT status and can be updated later before publishing. This action requires the ‘event_update’ OAuth scope.

Input Parameters

string
required
The name of the event. If not provided, a default name will be generated.
string
Event end date and time in ISO 8601 format (e.g., ‘2026-06-01T12:00:00-04:00’).
object
Location object for an event.
string
Event start date and time in ISO 8601 format (e.g., ‘2026-06-01T10:00:00-04:00’).
string
A description of the event.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_RESEND_TO_NON_OPENERSCreate a resend to non-openers activity for a primary email campaign activity, with a required resend subject and an optional delay in days or minutes. Requires the campaign_data OAuth scope.

Input Parameters

integer
The number of days to wait before Constant Contact resends the email. Valid values include 1 to 10 days. This property is mutually exclusive with delay_minutes.
integer
The number of minutes to wait before Constant Contact resends the email. Valid values include a minimum of 720 (12 hours) and a maximum of 14,400 minutes (10 days). This property is mutually exclusive with delay_days.
string
required
The subject line used when resending the email campaign activity.
string
required
The unique ID for the primary email campaign activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_CREATE_SOCIAL_POSTCreate a new social media post campaign. Use this action when you need to create a new social media post campaign in Constant Contact. This action allows you to create posts with content for multiple social profiles. Set the status to ‘DRAFT’ to save without publishing, or ‘SCHEDULED’ to schedule for publication at a specific time. This action requires the ‘campaign_data’ OAuth scope.

Input Parameters

string
Campaign name for this post. Optional on creation. If not provided, a default name will be generated. The value provided will be sanitized before saving.
string ("DRAFT" | "SCHEDULED" | "EXECUTING" | "ACTIVE" | "PAUSED" | "SUSPENDED" | "REMOVED" | "DONE" | "ERROR")
required
The status of the post on creation. Use ‘DRAFT’ to save without publishing, or ‘SCHEDULED’ to schedule for publication.
array
required
The list of per-profile posts that make up this campaign. Each entry specifies the content to post and the profiles to post it to. At least one profile_post is required.
string
The date and time to publish the post, in ISO-8601 format. Only applies when status is ‘SCHEDULED’. If not specified for a scheduled post, the publish job is scheduled to execute immediately.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CONTACTDELETE a specific contact from your Constant Contact account. Use this action when you need to permanently remove a contact from your account. This action is irreversible — once deleted, the contact cannot be recovered.

Input Parameters

string
required
The unique identifier of the contact to delete, in UUID format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CONTACT_LISTPermanently deletes a contact list by ID in Constant Contact without deleting its member contacts. The action returns a success flag after a successful request; deletion is irreversible.

Input Parameters

string
required
Unique ID of the contact list to delete. This is a UUID string (e.g., ‘1b48fb08-4abf-11f1-8f20-02420a320003’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CONTACTS_ACTIVITYDelete multiple contacts in bulk by submitting a contact_delete activity. Use this action when you need to delete multiple contacts at once by specifying contact IDs (up to 500) or list IDs (up to 50). The contacts are processed asynchronously and the response returns an activity_id to track the deletion progress. This action is irreversible — deleted contacts cannot be recovered once removed.

Input Parameters

array
The contacts on the lists (up to 50) specified will be deleted; mutually exclusive with contact_ids.
array
Specify up to 500 contacts by contact_id to delete; mutually exclusive with list_ids.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CONTACT_TAGDelete a specific contact tag from your Constant Contact account. Use this action when you need to remove an existing tag from your account. This action is irreversible — once deleted, the tag cannot be recovered.

Input Parameters

string
required
The unique identifier of the contact tag to delete, in UUID format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CONTACT_TAGSDelete one or more contact tags from the Constant Contact account in bulk. The operation creates an asynchronous deletion activity and returns an activity ID for tracking its progress.

Input Parameters

array
required
The list of tag IDs to delete. Maximum 500 tags per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CUSTOM_FIELDDELETE a specific contact custom field from your Constant Contact account. Use this action when you need to permanently remove a custom field that is no longer needed. This action is irreversible — the custom field cannot be recovered once deleted.

Input Parameters

string
required
The unique identifier of the custom field to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_CUSTOM_FIELDSDelete one or more custom fields from a Constant Contact account. Use when you need to remove outdated or unnecessary custom fields from your contact data. The deletion is processed asynchronously as an activity, so check the activity status to verify completion. This action is irreversible once the activity is processed.

Input Parameters

array
required
The array of custom field IDs to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_EMAIL_CAMPAIGNDELETE an Email Campaign from your Constant Contact account. Use this action when you need to permanently remove an email campaign that is no longer needed or was created in error. This action is irreversible — the email campaign cannot be recovered once deleted. The API returns 204 No Content on successful deletion with an empty response body.

Input Parameters

string
required
The unique identifier of the email campaign to delete, in UUID format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_LIST_ACTIVITYDelete one or more contact lists from your Constant Contact account by submitting a list delete activity. Use this action when you need to permanently remove contact lists that are no longer needed. This action is irreversible — once deleted, contact lists cannot be recovered. The deletion is processed as an async activity, and you can track the status using the activity_id returned.

Input Parameters

array
required
An array of contact list UUIDs to delete. Maximum 100 list IDs allowed per request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_DELETE_SEGMENTDelete a Constant Contact segment by ID without deleting its member contacts. On success, the action returns a success flag.

Input Parameters

integer
required
The system-generated unique ID that identifies a segment to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_EXPORT_CONTACTSCreate a bulk activity that exports contacts to a CSV file. Use this action when you need to export contacts from your Constant Contact account to a CSV file for backup, migration, or analysis purposes. You can export all contacts or filter by specific contact lists, segments, or status. The exported file will be available for download once the activity status changes to COMPLETE.

Input Parameters

string
The status of contacts to export. If not specified, exports contacts of all statuses. Valid values: ‘active’, ‘unconfirmed’, ‘remove_failed’, ‘removing’.
array
The unique identifiers of the contact lists to export. Only contacts from the specified lists will be included in the export. If not specified, exports all contacts.
string
The unique identifier of a contact segment to export. Only contacts matching the segment criteria will be included. Cannot be used together with list_ids.
array
The contact fields to include in the exported CSV file. Common values include: email_address, first_name, last_name, phone_number, street_address, city, state, postal_code, country, company_name, job_title. If not specified, exports all available contact fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_ACCOUNT_PHYSICAL_ADDRESSGET the Physical Address for the Account. Use this action when you need to retrieve the physical mailing address associated with the Constant Contact account, such as for compliance verification or contact information display.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_ACCOUNT_SUMMARYGET a summary of account details for a Constant Contact account. Use when you need to retrieve account information including company name, contact email, phone number, website, and optionally physical address or company logo.

Input Parameters

string
Include additional fields in the response. Use ‘physical_address’ and/or ‘company_logo’ as values. Multiple values should be comma-separated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_ACTIVITY_STATUSGET the status of a specific bulk activity. Use this action when you need to check the processing status of a bulk activity such as contact imports, file exports, or list membership changes in Constant Contact.

Input Parameters

string
required
The unique ID of the activity to retrieve status for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACTGET a contact by their unique ID. Use this action when you need to retrieve detailed information about a specific contact in your Constant Contact account, such as their email, name, company, phone numbers, addresses, custom fields, tags, or list memberships. Optionally include additional properties in the response using the include parameter.

Input Parameters

string
Additional properties to include in the response: custom_fields, list_memberships, phone_numbers, street_addresses, notes, sms_channel, taggings. Use comma-separated values for multiple includes.
string
required
The unique identifier of the contact to retrieve. This is a UUID string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACT_ACTIVITY_SUMMARY_REPORTGET contact tracking activity summary for a specific contact. Use this action when you need to retrieve email engagement metrics (sends, opens, clicks, bounces, forwards, unsubscribes) for a specific contact across a date range. This is useful for analyzing individual contact engagement patterns and campaign performance at the contact level. This is a read-only operation. Requires the contact_data OAuth scope.

Input Parameters

string
required
The ending date for the report, in ISO 8601 format (e.g., 2019-12-01T00:00:00-0500).
string
required
The starting date for the report, in ISO 8601 format (e.g., 2019-01-01T00:00:00-0500).
string
required
The contact ID for which to retrieve tracking activity data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACT_LISTGET details for a specific contact list by its ID. Use this action when you need to retrieve information about a specific contact list in your Constant Contact account, such as its name, description, status, and membership counts.

Input Parameters

string
required
Unique ID of the contact list to retrieve. This is a UUID string.
string
Include membership count details. Specify ‘active’, ‘removed’, or ‘all’ to include corresponding counts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACT_OPEN_AND_CLICK_RATES_REPORTGET average open and click rates for a contact. Use this action when you need to retrieve the average open rate, click rate, and activity count for a specific contact over a given time period. This is useful for analyzing individual contact engagement with your email campaigns. The response includes the average click rate, average open rate, contact ID, and the number of email activities included in the calculation.

Input Parameters

string
required
The ending date, in ISO 8601 format, to use to get campaigns. For example: 2019-12-01T00:00:00-0500.
string
required
The starting date, in ISO 8601 format, to use to get campaigns. For example: 2019-01-01T00:00:00-0500.
string
required
The contact ID for which to get tracking activity data. This is a UUID string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACTS_EXPORT_FILERetrieve the exported contacts file from a completed export contacts activity. Use when you need to download the CSV file containing the contacts that were exported using the export contacts feature. The file_export_id is obtained from the results section of the export contacts activity response.

Input Parameters

string
required
The unique ID of the exported file provided in the results section of the export contacts activity response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACT_SMS_ENGAGEMENT_HISTORYGET SMS Engagement History for a Contact. Use this action when you need to retrieve the SMS engagement history for a specific contact in Constant Contact. This returns details about SMS consent actions (opt-in, opt-out) and the methods used to add or update SMS contact details. The response contains an array of SMS channel history records with details about consent actions, timestamps, and source information depending on the type of SMS consent granted.

Input Parameters

string
required
The contact’s unique ID (UUID format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CONTACT_TAGGET Tag Details - Retrieves detailed information about a specific contact tag. Use this action when you need to fetch the name, source, creation/update timestamps, and optionally the count of contacts associated with a specific tag in Constant Contact.

Input Parameters

string
required
The ID that uniquely identifies a tag (UUID format).
boolean
Use to include (true) or exclude (false) the total number of tagged contacts (contacts_count) from the results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_CUSTOM_FIELDGET a custom field by its unique ID. Use this action when you need to retrieve details of a specific custom field from your Constant Contact account, such as its label, type, choices, or metadata configuration.

Input Parameters

string
required
The ID that uniquely identifies the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGNGET details for a single email campaign using its campaign ID. Use this action when you need to retrieve detailed information about a specific email campaign, including its name, subject line, status, content, sender information, and scheduling details. This action is read-only and does not modify any campaign data.

Input Parameters

string
required
The unique ID of the email campaign to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGN_ACTIVITYGET details for a specific email campaign activity by its ID. Use this action when you need to retrieve information about a specific email campaign activity in your Constant Contact account, such as its current status, content, or configuration details.

Input Parameters

array
Use the include query parameter to enter a comma separated list of additional email campaign activity properties for the V3 API to return. Valid values are physical_address_in_footer, permalink_url, html_content, and document_properties.
string
required
The unique ID for an email campaign activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGN_ACTIVITY_PREVIEWGET the HTML Preview of an Email Campaign Activity. Use this action when you need to retrieve the HTML and plain text preview of an email campaign activity, including subject line, from address, preheader text, and content. This is useful for reviewing how an email will appear before sending it.

Input Parameters

string
required
The unique ID for an email campaign activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGN_ACTIVITY_SCHEDULEGET an email campaign activity schedule. Use this action when you need to retrieve the scheduled date(s) for a specific email campaign activity in Constant Contact. This returns all scheduled send times for the campaign, which can be used to verify when emails will be sent to contacts. This action is read-only and does not modify any campaign data.

Input Parameters

string
required
The unique ID for an email campaign activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGN_ACTIVITY_SEND_HISTORYRetrieve the send history of an email campaign activity, including send dates, contact counts, recipient lists or segments, and send status. A 404 response is returned as an empty history, so an empty result does not establish that the activity exists.

Input Parameters

string
required
The unique ID for an email campaign activity. You can return the send history for primary_email and resend role email campaign activities.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGN_ID_XREFSGET a collection of V2 and V3 API Email Campaign ID cross-references. Use this action when you need to map V2 API campaignId values to V3 API campaign_id and campaign_activity_id values for email campaigns. The endpoint accepts up to 50 V2 campaignId values in each request.

Input Parameters

string
required
Comma separated list of V2 API campaignId values. You can enter up to 50 V2 campaignId values in each request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EMAIL_CAMPAIGNS_STATS_REPORTGET statistics for one or more email campaigns. Use this action when you need to retrieve performance statistics for email campaigns, including open rates, click rates, bounce rates, unsubscribe rates, and delivery counts. You can request statistics for multiple campaigns by providing comma-separated campaign IDs. This is a read-only operation that returns aggregated email campaign performance metrics. The response includes both percentage-based and count-based statistics for each campaign.

Input Parameters

string
required
A comma-separated list of campaign_ids (UUIDs) for which to retrieve statistics. Each campaign ID should be a valid UUID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_EVENTRetrieve a single Constant Contact event by ID. The returned details include mapped event fields such as name, description, timing, status, format, and registration URL.

Input Parameters

boolean
Use to include (true) or exclude (false) event setting properties in the results. Default is true.
string
required
The unique ID of the event to retrieve. This is a UUID string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_LIST_ID_XREFSGET a collection of V2 and V3 API List IDs cross-references. Use this action when you need to map V2 API sequence_ids to V3 API list_ids for contact lists. The endpoint accepts up to 500 sequence_ids at a time and returns the corresponding V3 list_id values for each V2 sequence_id.

Input Parameters

string
required
Comma delimited list of V2 API list ids to cross-reference with the V3 API list_id value. Endpoint accepts a maximum of 500 ids at a time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_PARTNER_WEBHOOK_SUBSCRIPTIONGET details for a specific Partner Webhook Topic Subscription by its ID. Use this action when you need to retrieve information about a specific webhook topic subscription in your Constant Contact account, such as the webhook callback URI, topic name, description, and topic type.

Input Parameters

string
required
Identifies a webhook topic.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_RESEND_TO_NON_OPENERSGET Details for a Resend to Non-openers Campaign Activity. Use this action when you need to retrieve details about a resend to non-openers campaign activity. This includes information about the resend schedule, timing, status, and subject line used for the campaign. This action requires the campaign_activity_id which can be obtained from the campaign activities endpoint or campaign details endpoint.

Input Parameters

string
required
The unique ID for the primary email campaign activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_GET_SEGMENTGET details for a specific segment by its unique ID. Use this action when you need to retrieve detailed information about a specific segment in your Constant Contact account, such as its name, segment criteria, and creation/update timestamps. This is a read-only operation that does not modify any data.

Input Parameters

integer
required
The system-generated unique ID that identifies a segment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_IMPORT_CONTACTS_FROM_FILEImport contacts from a CSV file into Constant Contact lists as an asynchronous activity. The CSV must include an email or sms_number column and can include custom fields with the cf: prefix.

Input Parameters

array
required
List of contact list IDs to add imported contacts to. Array of up to 50 UUID values.
string
required
The CSV file to import. Can be either an uploaded file or inline file data with content_base64 and name. The CSV must include either ‘email’ or ‘sms_number’ as a column heading. Other supported columns: first_name, last_name, phone, job_title, anniversary, birthday_day, birthday_month, company_name, street, street2, city, state, zip, country, sms_consent_date. Custom fields can use ‘cf:’ prefix.
string
How SMS consent was provided for contacts with sms_number. Use ‘explicit’ if contacts provided consent and include sms_consent_date column. Use ‘not_set’ if consent not yet provided. Only required when importing contacts with sms_number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_IMPORT_CONTACTS_FROM_JSONBulk import contacts into Constant Contact using JSON format. Use this action when you need to add multiple contacts at once by providing contact data in JSON format. Each contact must have either an email_address or phone_number. Optionally, you can specify list_ids to add contacts to specific contact lists during import. The contacts are processed asynchronously and the response returns an activity_id to track the import progress.

Input Parameters

array
Array of list IDs to add the imported contacts to. Optional.
array
required
Array of contact objects to import. Each contact must have either an email_address or phone_number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_ACCOUNT_EMAIL_ADDRESSESGET a Collection of Account Email Addresses. Use this action when you need to retrieve all email addresses associated with a Constant Contact account. Supports filtering by confirmation status (CONFIRMED/UNCONFIRMED), role code (CONTACT/BILLING/REPLY_TO/JOURNALING/OTHER), or a specific email address. This is a read-only operation that requires the ‘account_read’ OAuth scope.

Input Parameters

string ("CONTACT" | "C" | "BILLING" | "B" | "JOURNALING" | "J" | "REPLY_TO" | "R" | "OTHER" | "O")
Email role codes for account email addresses.
string
Use the email_address query parameter to search for a specific account email address.
string ("CONFIRMED" | "C" | "UNCONFIRMED" | "U")
Email confirmation status values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_ACCOUNT_USER_PRIVILEGESGet the user privileges associated with your access token. Use this action when you need to determine what permissions the authenticated user has within the Constant Contact API. This is a read-only operation that retrieves privileges without requiring any parameters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_ACTIVITY_STATUSESList a page of bulk activities, optionally filtered by processing, completed, cancelled, failed, or timed_out status. This can help monitor batch operations such as contact imports, file exports, or list membership changes.

Input Parameters

integer
Number of results per page (1-500, default 25).
string ("processing" | "completed" | "cancelled" | "failed" | "timed_out")
Possible states for a bulk activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_CONTACT_LISTSRetrieve a page of Constant Contact lists, optionally filtering by name or status and including membership counts. The limit controls the number requested, and the response may include a next-page link.

Input Parameters

string
Filter contact lists by name. Returns exact matches only.
integer
Number of contact lists to return per page. Valid range: 1-500.
string
Filter contact lists by status. Valid values: ‘active’ or ‘deleted’.
boolean
Include membership count for each list. When true, the response includes membership_count for each contact list.
string
Include membership counts. Valid values: ‘active’, ‘removed’, or ‘all’. Used with include_count=true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_CONTACTSRetrieve a page of contacts from Constant Contact, with optional filters for status, email, lists, segments, tags, or update date. The request allows a limit of up to 500 contacts and the response may include pagination links.

Input Parameters

string
Filter contacts by tag IDs. Use comma-separated tag IDs for multiple tags.
string
Filter contacts by email address.
integer
Number of contacts to return per page (1-500, default 25).
string
Filter contacts by list membership. Use comma-separated list IDs for multiple lists.
string
Filter contacts by status: active, deleted, not_set, pending_confirmation, temp_hold, or unsubscribed.
string
Additional properties to include in the response: custom_fields, list_memberships, phone_numbers, street_addresses, notes, sms_channel, taggings. Use comma-separated values for multiple includes.
string
Filter contacts by segment ID.
boolean
Include total count of contacts in the response.
string
Filter contacts updated on or after a specific date (ISO-8601 format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_CONTACT_TAGSRetrieve a page of contact tags for the Constant Contact account, with optional contact counts. The read-only response includes tag metadata and may include a next-page link.

Input Parameters

integer
Number of tags to return (1-500). Defaults to 25.
boolean
Include the total contact count for each tag in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_CUSTOM_FIELDSRetrieve a page of contact custom field definitions, including labels, types, and available choices. The result may include a link to the next page.

Input Parameters

integer
Specifies the number of results displayed per page of output, from 1 - 100, default = 50.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_CAMPAIGNSList the first page of email campaigns, with optional creation-date filters and a page-size limit. Results can include campaign metadata and a next-page link, but this action does not accept a pagination cursor.

Input Parameters

integer
Number of email campaigns to return (1-500).
string
Filter for campaigns created after this date (ISO 8601 format, e.g., 2024-01-01T00:00:00Z).
string
Filter for campaigns created before this date (ISO 8601 format, e.g., 2024-01-15T00:00:00Z).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_CAMPAIGN_SUMMARIES_REPORTRetrieve the first page of the email campaign summary report, including unique activity counts and aggregate percentage rates for campaigns on that page. The response can include a next-page link, but this action does not accept a pagination cursor.

Input Parameters

integer
The number of email campaign summaries to return on a single page (1-500, default 25).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_DID_NOT_OPENS_REPORTGET an Email Did Not Opens Report to retrieve a list of contacts who did not open a specific email campaign. Use this action when you need to analyze email engagement by identifying contacts that received but did not open a specific email campaign activity. This is useful for re-engagement campaigns, follow-up emails, or engagement analysis. This is a read-only operation that retrieves tracking data without modifying any data.

Input Parameters

integer
The number of tracking activities to return on a page (1-500, default 25).
string
required
The ID that uniquely identifies the email campaign activity to use for this report. This is a UUID string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_FORWARDS_REPORTGET an Email Forwards Report for a specific email campaign activity. Use this action when you need to retrieve tracking data about email forwards for a specific email campaign activity in Constant Contact. This returns a list of contacts who forwarded the email, including their contact details and the timestamp of the forward. This is a read-only operation suitable for analyzing email campaign engagement through forwards.

Input Parameters

integer
The number of tracking activities to return on a page (1-500, default 25).
string
required
The unique identifier of the email campaign activity to retrieve forwards tracking data for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_OPTOUTS_REPORTGET an Email Opt-outs Report for a specific email campaign activity. Use this action when you need to retrieve a list of contacts who have opted out of a specific email campaign. This provides detailed tracking information including contact identifiers, email addresses, opt-out timestamps, and reason for opting out. This is a read-only operation suitable for generating reports, analyzing campaign performance, or syncing opt-out data with external systems. Note: The campaign_activity_id should be the UUID of an email campaign activity, not the campaign itself.

Input Parameters

integer
The number of tracking activities to return on a page (1-500, default 25).
string
required
The ID that uniquely identifies the email campaign activity to use for this report.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EMAIL_UNIQUE_OPENS_REPORTGET an email unique opens report for a campaign activity. Use this action when you need to retrieve a list of contacts who uniquely opened a specific email campaign activity. This is useful for analyzing email engagement, understanding which contacts opened your emails, and tracking campaign performance. The report includes contact details such as email address, name, device type, and the timestamp of each unique open event. Note: This is a read-only operation that retrieves tracking data.

Input Parameters

integer
The number of tracking activities to return on a page. Default is 500 if not specified.
string
required
The ID that uniquely identifies the email campaign activity to use for this report.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EVENTSRetrieve a page of events from a Constant Contact account, optionally filtered by status. The response can include pagination cursors, but this action does not accept a cursor to retrieve another page.

Input Parameters

integer
Number of events to return per page (1-100, default 25).
string
Filter events by status. Valid values: DRAFT, ACTIVE, CANCELLED, or CLOSED.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_EVENT_TRACK_REGISTRATIONSGET registrations for an event track to retrieve a list of registrations. Use this action when you need to fetch registrations for a specific event track in your Constant Contact account, with optional filtering by registration status, payment status, or search text. Supports pagination using cursors and allows sorting by various fields. This is a read-only operation suitable for retrieving registration collections for reporting, analytics, or event management purposes.

Input Parameters

string
Cursor for pagination used to get the next page of results. Mutually exclusive with prev.
string
Cursor for pagination used to get the previous page of results. Mutually exclusive with next.
integer
Limit the number of results returned per page (1-500, default 25). If specifying both limit and page_size, they must be the same value.
string ("first_name" | "last_name" | "email_address" | "registration_status" | "payment_status" | "tickets" | "total")
Sort by field options for registration results.
string
required
The unique identifier of the event. This is a UUID string.
string
required
The unique identifier of the event track. This is a short string key.
integer
Alternative to limit parameter to limit the number of results returned per page. If specifying both limit and page_size, they must be the same value.
string ("ASC" | "DESC")
Sort order direction.
string
Filter registration results by first name, last name, or email address.
string ("PENDING" | "PAID" | "REFUNDED" | "CANCELLED" | "FAILED" | "CHARGED_BACK")
Payment status filter values.
string ("PENDING" | "REGISTERED" | "CANCELED" | "EXPIRED" | "IN_PROGRESS" | "FAILED")
Registration status filter values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_LANDING_PAGE_CONTACT_OPENS_REPORTRetrieve a contact opens report for a landing page campaign activity, optionally filtering contacts by name or email. The response contains tracking activities and may include a next-page link; this action accepts a page size but no pagination cursor.

Input Parameters

integer
Number of contact tracking activities to return per page (1-500, default 50).
string
Filter to return only contacts that contain a certain value. This parameter does full and partial matches and applies to the contact first name, last name, and email fields.
string
required
The landing page campaign_activity_id (UUID) to use to get unique contact open results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_LANDING_PAGE_UNIQUE_CONTACT_ADDS_REPORTGET a Unique Contacts Adds Landing Page Report for a specific landing page campaign activity. Use this action when you need to retrieve a list of contacts that were added through a landing page campaign. This report shows which contacts signed up via the landing page and includes their contact details along with timing information. This is useful for analyzing landing page conversion performance and contact acquisition. The results are paginated with a default limit of 50 items per page (maximum 500). Use the contacts_filter parameter to search for specific contacts by name or email.

Input Parameters

integer
Use to limit the number of contact tracking activities to return on a single page. The default is 50 and the maximum is 500 per page.
string
Use to filter the results to only include contacts that contain a certain value. This parameter does full and partial matches and applies to the contact first name, last name, and email fields. For example: Josie or Jo.
string
required
The landing page campaign_activity_id (UUID) to use to get unique contact results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_LANDING_PAGE_UNIQUE_CONTACT_CLICKS_REPORTGET unique contact clicks data for a landing page campaign. Use this action when you need to retrieve detailed click tracking data for contacts who clicked on links in a landing page campaign. This includes contact information (name, email), click timestamps, device type, and the specific URLs clicked. The results are paginated and can be filtered by contact name or email.

Input Parameters

integer
Use to limit the number of contact tracking activities to return on a single page. The default is 50 and the maximum is 500 per page.
string
Use to filter the results to return only contacts that match a contacts full or partial first or last name, or email. For example: Josie or Jo.
string
required
The landing page campaign_activity_id (UUID) to use to get unique contact click results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_LANDING_PAGE_UNIQUE_CONTACT_OPENS_REPORTGET a Unique Contacts Opens Landing Page Report to retrieve a list of contacts who uniquely opened a specific landing page campaign. Use this action when you need to analyze landing page engagement by identifying contacts that opened a specific landing page campaign activity. This is useful for engagement analysis, follow-up actions, or campaign performance evaluation. This is a read-only operation that retrieves tracking data without modifying any data.

Input Parameters

integer
The number of contact tracking activities to return on a single page (1-500, default 25).
string
Filter to only include contacts that contain a certain value. This parameter does full and partial matches and applies to the contact first name, last name, and email fields.
string
required
The landing page campaign_activity_id (UUID) to use to get unique contact open results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_LANDING_PAGE_UNIQUE_CONTACT_UPDATES_REPORTGET a Unique Contacts Updates Landing Page Report for a specific landing page campaign activity. Use this action when you need to retrieve tracking data about contacts who made profile updates after visiting a landing page. This returns a list of contacts who updated their information, including their contact details and the timestamp of the update. This is a read-only operation suitable for analyzing landing page engagement and contact data quality. Note: The campaign_activity_id should be the UUID of a landing page campaign activity.

Input Parameters

integer
The number of contact tracking activities to return on a single page (1-500, default 25).
string
Filter to return only contacts that contain a certain value in their first name, last name, or email fields. Supports full and partial matches. For example: ‘Josie’ or ‘Jo’.
string
required
The unique identifier of the landing page campaign activity (UUID) to retrieve unique contact updates for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_SEGMENTSList a page of segments in a Constant Contact account, optionally sorted by date, name, or segment ID. The response can include segment names, timestamps, and a next-page link.

Input Parameters

integer
Number of segments to return per page. Valid range: 1-1000.
string
Sort segments by field. Valid values: date, name, or segment_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_SMS_CAMPAIGN_SUMMARIES_REPORTGet an SMS campaign summaries report for a specified date range. The report includes individual campaign counts and aggregate delivery, click, bounce, and unsubscribe rates for the current results page.

Input Parameters

integer
Use to limit the number of results to return on a single page (from 1 to 50). The default setting is 50.
string
Use to limit the results to include SMS campaign summary details for SMS campaigns sent on or before the end_at date you specify. ISO 8601 format.
string
required
Use to limit the results to include SMS campaign summary details for SMS campaigns sent on or after the required start_at date you specify. ISO 8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_SOCIAL_CONNECTIONSGET social network connections for a Constant Contact account. Use this action when you need to retrieve all social network accounts (such as Facebook, Instagram, LinkedIn, or TikTok) that are connected to the Constant Contact account. This is a read-only operation that returns information about each connection including account details and connection status. The response includes a list of connections, each containing account information (display name, username, profile URL) and connection status (active, disconnected, error, rate_limited).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_SOCIAL_HASHTAG_GROUPSGET hashtag groups - Retrieves a paginated list of social hashtag groups. Use this action when you need to fetch all hashtag groups available in your Constant Contact account. Hashtag groups are named collections of hashtags that can be reused when creating social posts. Results are paginated with a maximum page size of 5 groups per request. This is a read-only operation that returns hashtag group metadata such as names, IDs, and the list of hashtags contained in each group.

Input Parameters

integer
Page number to retrieve (0-based).
integer
Maximum number of hashtag groups to retrieve per page. Default and maximum is 5.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_LIST_SOCIAL_PROFILESGET social media profiles from Constant Contact. Use this action when you need to retrieve all social media profiles (such as Facebook Business Pages, Instagram profiles, Twitter accounts, LinkedIn pages, or TikTok accounts) connected to a Constant Contact account. This is a read-only operation that returns profile information including connection status, handles, URLs, and optional accessibility status. Note: Due to performance and/or rate-limit issues, some properties may be cached. Where possible, caching will be limited to 15 minutes.

Input Parameters

array
Optional sub-resources to include. Use ‘accessible’ to check if profiles are accessible on the network.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_REMOVE_CONTACT_TAGGINGRemove tagging from contacts in Constant Contact. Use this action when you need to asynchronously remove tagging from contacts identified by specific contact IDs, list IDs, tag IDs, all active contacts, or new subscribers. The removal is processed as an asynchronous activity - check the activity status to monitor progress.

Input Parameters

object
required
Select the source used to identify contacts from which tags will be removed. Source types are mutually exclusive.
object
Configuration to exclude specific contacts from the tag removal.
array
required
An array of tag IDs to remove from contacts meeting the specified source criteria. Maximum 50 tags.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_REMOVE_CONTACT_TAGGINGSRemove tags from contacts in Constant Contact. Use this action when you need to asynchronously remove one or more tags from contacts identified by specific contact IDs, list IDs, all active contacts, or new subscribers. The removal is processed as an asynchronous activity - check the activity status to monitor progress.

Input Parameters

object
required
Select the source used to identify contacts from which tags will be removed. Source types are mutually exclusive.
object
Configuration to exclude specific contacts from the tag removal.
array
required
An array of tag IDs to remove from contacts meeting the specified source criteria.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_REMOVE_LIST_MEMBERSHIPSCreate a Remove Contacts from Lists activity to remove contacts from one or more lists. Use this action when you need to bulk-remove contacts from Constant Contact lists. The activity is queued for asynchronous processing and returns an activity_id that can be used to track the status of the operation.

Input Parameters

object
required
Specifies the contacts to remove from target list(s) using mutually exclusive properties.
object
Optional contact IDs to exclude from removal.
array
required
Specify up to 50 target list_id values from which to remove contacts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_RENAME_EMAIL_CAMPAIGNPATCH (Update) the name of an existing email campaign in Constant Contact. Use this action when you need to rename an existing email campaign. You must provide the campaign ID of the email campaign you want to rename and the new name for the campaign. The campaign name must be unique within your account. Note: This action only updates the campaign name. Other campaign properties remain unchanged. Attempting to use a duplicate name will result in a 409 Conflict error.

Input Parameters

string
required
The new name for the email campaign. The name must be unique within your account. Maximum 80 characters.
string
required
The unique identifier for the email campaign to rename (UUID format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_RENAME_SEGMENTPATCH (rename) an existing segment in Constant Contact. Use this action when you need to rename an existing segment. You must provide the segment ID of the segment you want to rename and the new name for the segment. The segment name must be unique within your account. Note: This action only updates the segment name. Other segment properties (such as segment_criteria) remain unchanged. Attempting to use a duplicate name will result in a 409 Conflict error.

Input Parameters

string
required
The new name for the segment. The name must be unique within your account.
integer
required
The system generated ID that uniquely identifies the segment that you want to rename.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_RESUBSCRIBE_CONTACTResubscribe an unsubscribed contact to one or more contact lists. Use this action when you need to reactivate a contact that was previously unsubscribed and add them back to specific contact lists. The contact’s status will be changed from ‘unsubscribed’ to ‘active’, and they will be added to the specified lists. This action is useful for managing contact re-engagement campaigns or when a contact requests to be resubscribed after previously opting out.

Input Parameters

array
required
Array of contact list ID values. Constant Contact adds the resubscribed contact to the contact lists you provide in the array.
string
required
The ID that uniquely identifies the contact to resubscribe (UUID format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UNDO_CHECK_IN_EVENT_TICKETSUndo check-in for event tickets identified by their order ticket keys. On success, the action returns a success flag.

Input Parameters

string
required
The unique identifier of the event, in UUID format.
array
required
Array of order ticket keys to mark as not checked in.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_ACCOUNT_DETAILSUpdate account summary details for the authenticated account, including the owner’s contact information, organization name, country and state, time zone, and website.

Input Parameters

string
The organization’s website URL.
string
The account owner’s last name.
string
The account owner’s first name.
string
The two-letter ISO 3166-1 code used to specify the state to associate with the account. This property is required if the country_code is US (United States).
string
The two-letter ISO 3166-1 code representing the organization’s country.
string
The time zone to use for the account; as defined in the IANA time-zone database.
string
The confirmed email address that is associated with the account owner.
string
The account owner’s contact phone number (up to 25 characters in length).
string
The name of the organization that is associated with this account.
string
The phone number of the organization that is associated with this account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_ACCOUNT_PHYSICAL_ADDRESSPUT (update) the Physical Address for an Account. Use this action when you need to update or set the physical address information for a Constant Contact account. This action sends a PUT request to update the account’s physical address with the provided address details. Required fields: address_line1, city, and country_code. For US or CA addresses, include state_code and postal_code. For other countries, use state_name instead of state_code.

Input Parameters

string
required
The city where the organization is located.
string
The two letter ISO 3166-1 code for the organization’s state. Only used when country_code is US or CA.
string
Use if the state is not in the US or Canada. Do not use when country_code is US or CA.
string
The postal code (ZIP code) of the organization. Required if country_code is US or CA.
string
required
The two letter ISO 3166-1 code for the organization’s country.
string
required
Line 1 of the organization’s street address.
string
Line 2 of the organization’s street address.
string
Line 3 of the organization’s street address.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_CONTACTUpdate an existing Constant Contact contact by ID using provided details such as name, email address, phone numbers, addresses, or list and tag assignments. The action declares the contact_update OAuth scope.

Input Parameters

array
List of tag IDs to apply to the contact.
array
List of list IDs to add the contact to.
string
The contact’s job title.
string
The contact’s last name.
string
required
The unique ID of the contact to update (UUID format).
string
The contact’s first name.
string
The contact’s company name.
array
List of custom field key-value pairs. Example: [{‘custom_field_id’: ‘cf1’, ‘value’: ‘vip’}]
object
Email address object for a contact.
array
List of phone numbers associated with the contact.
string
The source of the update. Values: ‘Contact’ (manually updated), ‘API’ (updated via API), ‘Import’ (bulk import), ‘Survey’ (from survey).
array
List of street addresses associated with the contact.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_CONTACT_LISTUpdate an existing Constant Contact list by ID, supplying its name and optionally its description or favorite status. The name must be unique within the account; a duplicate may result in a conflict error.

Input Parameters

string
required
The name of the contact list (must be unique within the account).
string
required
The unique ID of the contact list to update (UUID format).
boolean
A boolean value indicating if the contact list is a favorite.
string
An optional description for the contact list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_CONTACT_TAGPUT (Update) a Tag. Use this action when you need to rename an existing contact tag in Constant Contact. The tag name must be unique within your account.

Input Parameters

string
required
The new tag name to use. The tag name must be unique.
string
required
The system generated ID used to uniquely identify the tag that you want to rename (UUID format).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_CUSTOM_FIELDUpdate an existing contact custom field in Constant Contact. Use this action when you need to modify the label, type, or choices of an existing custom field. Properties omitted in the PUT request are overwritten with null values. This action is idempotent - updating a field with the same data produces the same result.

Input Parameters

string ("string" | "date" | "currency" | "number" | "datetime" | "phone_number" | "single_select" | "multi_select")
required
The data value type the custom field accepts.
string
required
The custom field name to display in the UI (free-form text).
array
Array of choices for custom fields of type single_select or multi_select. Maximum 100 elements for dropdown, 20 for checkbox/radio.
string
required
The ID that uniquely identifies the custom field to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_EMAIL_CAMPAIGN_ACTIVITYUpdate an email campaign activity by ID, including its content, subject, sender information, and recipient lists. Only format types 1 and 5 support custom HTML content; a physical address in the footer is required for CAN-SPAM compliance.

Input Parameters

string ("primary_email" | "permalink" | "resend")
Valid role values for an email campaign activity.
string
required
The email ‘Subject’ field for the email campaign activity.
string
required
The email ‘From Name’ field for the email campaign activity.
string
The email preheader for the email campaign activity. Only format_type 3, 4, and 5 support this property.
string
required
The email ‘From Email’ field for the email campaign activity. Must use a confirmed Constant Contact account email address.
string
Identifies a campaign in the V3 API.
integer
Identifies the type of email format (1=legacy custom code, 2=2nd gen editor, 3=3rd gen editor, 4=4th gen editor, 5=custom code V3).
array
The contacts that Constant Contact sends the email campaign activity to as an array of segment_id values. Only format_type 3, 4, and 5 support segments.
string
Identifies the email layout and design template that the email campaign activity is using as a base.
string
The HTML or XHTML content for the email campaign activity. Only format_type 1 and 5 can contain html_content.
The permanent link to a web accessible version of the email campaign content.
string ("DRAFT" | "SCHEDULED" | "EXECUTING" | "DONE" | "ERROR" | "REMOVED")
Valid status values for an email campaign activity.
string
required
The email ‘Reply To Email’ field for the email campaign activity. Must use a confirmed Constant Contact account email address.
array
The contacts that Constant Contact sends the email campaign activity to as an array of contact list_id values. You cannot use contact lists and segments at the same time.
object
Optional properties for legacy format type emails (format_type 1 and 2).
string
required
The unique ID for the email campaign activity you are updating.
Physical address details displayed in the email footer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_EVENTUpdate an existing Constant Contact event by PATCH, supplying the event details to change, such as name, description, dates, location, or status. The action returns a success message and event ID and requires the campaign_data OAuth scope.

Input Parameters

string
The name of the event (must be unique for the account).
string
The title for the event. The title does not have to be unique for an account.
string
Specifies the event’s current status.
object
Address object for event location.
object
Contact object for event organizer.
string
required
The ID that uniquely identifies the event to update.
string
The date the event ends (ISO format).
string
The time zone where the event takes place.
string
The short code to use for the event.
string
Identifies the event type.
string
Provides the event description.
string
The date the event starts (ISO format).
string
The accepted currency for payments (e.g., ‘USD’, ‘EUR’).
string
Specifies if the event is physical and/or virtual, or to be determined.
object
Event metadata object.
object
Online meeting details for virtual events.
boolean
If true, sends an email to the event owner when a registration is made.
boolean
Display or hide event contact information on the registration form and registration confirmation message.
boolean
Display or hide the event end time on the registration form and registration confirmation message.
boolean
Display the time zone on the registration form and registration confirmation message.
boolean
Display the event on the Event Calendar.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_EVENT_TRACK_REGISTRATION_PAYMENT_STATUSUpdate the payment status for event track registrations in Constant Contact. Use this action when you need to update the payment status for one or more registrations of an event track. This is commonly used to mark registrations as paid, pending, refunded, or failed after processing payments. The action requires the event ID, track ID, the new payment status, and a list of registration IDs to update. Note: Some registrations may fail to update while others succeed (207 Multi-Status). Check the response results for details on each registration update outcome.

Input Parameters

string
required
The ID that uniquely identifies the event (UUID format).
string
required
The track key that uniquely identifies the event track.
string
required
The new payment status to set. Common values: ‘Pending’, ‘Paid’, ‘Refunded’, ‘Failed’.
array
required
List of registration IDs to update with the new payment status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_EVENT_TRACK_REGISTRATIONSPUT (update) registration status for event track registrations. Use this action when you need to update the registration status (APPROVED, CANCELED, or DECLINED) for one or more registrations within an event track in Constant Contact. This action supports batch updates - you can update multiple registrations at once by providing a list of registration IDs. The action also supports optional inventory management via the return_items_to_inventory parameter. This action requires the ‘campaign_data’ OAuth scope.

Input Parameters

string
required
The ID that uniquely identifies the event.
string
required
The track key that uniquely identifies the event track.
boolean
Override count flag. When set to true, forces the registration count to be incremented.
array
required
List of registration IDs to update.
boolean
Override item count flag. When set to true, forces the item count to be incremented.
string
required
New registration status to set. Valid values: PENDING, REGISTERED, CANCELED, EXPIRED, IN_PROGRESS, FAILED.
boolean
Return items to inventory flag. Defaults to true. Set to false to keep items consumed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONSTANT_CONTACT_UPDATE_SEGMENTPUT (update) an existing segment in Constant Contact. Use this action when you need to update an existing segment’s name or contact selection criteria. The segment ID is required to identify which segment to update. Both name and segment_criteria are required in the request body. Note: The segment_criteria must be formatted as single-string escaped JSON, and the top-level group type must be ‘and’. Attempting to use duplicate names will result in a 409 Conflict error.

Input Parameters

string
required
The segment’s unique descriptive name.
integer
required
The system generated ID that uniquely identifies the segment that you want to modify.
string
required
The segment criteria formatted as single-string escaped JSON. Specifies the contact data that Constant Contact uses to identify contacts meeting your criteria. The top-level group type must be ‘and’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not