Constant Contact tools
The 12 Constant Contact operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List contactsGETLists the contacts of the account, leaving deleted ones out by default, optionally filtered by email, list, status or date. The response has contacts and, when there are more, _links.next.href with the cursor of the next page.
- Create contactPOSTCreates a contact and returns it with its contact_id. Send create_source and at least email_address, first_name or last_name. An email address that already exists in the account answers 409.
- Update contactPUTUpdates a contact by replacing its core fields: email_address, names, job_title, company_name, birthday and anniversary left out become empty, so send the current values too, from List contacts. Subresources left out are kept, and one that is sent replaces the current one.
- List contact listsGETLists the contact lists with their list_id, name and description. An account has up to 1000 lists, and one page brings up to 1000.
- Create contact listPOSTCreates an empty contact list and returns it with its list_id. A name already used by another list answers 409.
- List email campaignsGETLists the email campaigns, most recently updated first, with campaign_id, name, type and current_status, including the deleted ones (Removed). Up to 500 per page; reach older ones with before_date and after_date. The activity ids come from Get email campaign.
- Get email campaignGETReturns one email campaign with its name, current_status and campaign_activities. The campaign_activity_id with role primary_email is the one the activity tools take.
- Create email campaignPOSTCreates a draft email campaign with custom HTML content and returns it with campaign_activities, where the primary_email activity is. To send it, set the lists with Update email campaign activity and then use Schedule email campaign activity.
- Get email campaign activityGETReturns an email campaign activity: sender, subject, preheader, contact_list_ids or segment_ids, format_type and current_status. html_content and physical_address_in_footer come back only when asked in include.
- Update email campaign activityPUTUpdates the primary_email activity of a campaign in DRAFT or DONE status. It replaces the properties: send the current sender, subject, preheader and lists from Get email campaign activity along with the changes, because what is left out is cleared. html_content and physical_address_in_footer are kept when not sent.
- Schedule email campaign activityPOSTSends the primary_email activity of a campaign to its lists or segment, right away or at scheduled_date. Set the lists first with Update email campaign activity. An activity in DONE status goes only to contacts added to its lists since the last sending.
- Get email campaign statsGETReturns the tracking statistics of a sent email campaign: unique sends, opens, clicks, bounces, forwards and opt-outs in stats, the rates in percents, and last_refresh_time.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
