Constant Contact V3 API Release Notes.

V3 API Release Notes introduce newly released endpoints and notable updates made available in each release.

May 2019

New endpoints

This release provides support and documentation for the following new Email Campaign endpoints:

Endpoint (method/ route) & API Reference links Description
PUT /emails/activities/{campaign_activity_id} Update an email campaign activity.
POST /emails/activities/{campaign_activity_id}/schedules Schedule an email campaign activity.
GET /emails/activities/{campaign_activity_id}/schedules Get the schedule of an email campaign activity.
DELETE /emails/activities/{campaign_activity_id}/schedules Delete the schedule of an email campaign activity.

This release provides support and documentation for the following new Account Services endpoints:

Endpoint (method/ route) & API Reference links Description
GET /account/user/privileges Get the user privileges associated with your access token.
GET /account/summary Get a summary of account details, such as the organization name and account contact information for a specific account.

Updates

  • User Privileges – The V3 API now requires specific user privileges to access endpoints. Users in Constant Contact have different privileges depending on their role in an account. Users can have the role of account owner, account manager, or campaign creator. If you send an API request on behalf of a user that lacks the necessary privileges, the V3 API returns a 403 Forbidden error.

    For more information on the user privileges associated with each role in Constant Contact, see the User Roles and Privileges Overview. The User Roles and Privileges Overview and the API Reference both list the user privileges required by each V3 API endpoint and method. You can also use the Get User Privileges endpoint to return the user privileges associated with your access token.

  • Get a Deleted Contact by Email Address – The Get Contacts Collection endpoint now correctly returns results for deleted contacts when you search using an email address. For example, to return a deleted contact using their email address you can use GET https://api.cc.email/v3/contacts?email=deleted_email@example.com&status=deleted. The Get Contacts Collection endpoint does not return deleted contacts by default. Use the status query parameter with the value all or deleted to return deleted contacts.
  • Email Campaign Scheduling – Use the new Update an Email Campaign Activity method to add contact lists to an email campaign activity. This allows you to specify which contacts Constant Contact should send the email campaign activity to when you use the new Schedule an Email Campaign Activity method. You can also use the Get a Single Email Campaign Activity method to return the contact lists associated with an email campaign activity. Though the Update an Email Campaign Activity method also supports using segments to specify which contacts Constant Contact should send the email to, the fully segmentation workflow is not currently supported. The V3 API does not have methods to create new segments or get segment_id values yet.
  • Import Custom Field Data – You can now import custom field data when you use the Import Contacts using a CSV File and the Import Contacts using a JSON Payload methods. By prefixing the custom field name with cf:, you can import custom fields that have the same name as contact properties. The custom fields must already exist in the Constant Contact account you are using. You can import up to 25 different custom fields in each contact.

March 2019

New endpoints

This release provides support and documentation for the following new Email Campaign endpoints:

Endpoint (method/ route) & API Reference links Description</i>
POST /emails Create a new email campaign in your email campaign collection.
GET /emails Get a collection of email campaigns.
GET /emails/{campaign_id} Get a single email campaign and a list of associated campaign activities.
GET /emails/activities/{campaign_activity_id} Get details about a specific email campaign activity.
GET /emails/campaign_id_xrefs Get a collection of V2 and V3 campaign ids.
PATCH /emails Rename an existing email campaign.

Updates

  • Scopes – Use the new campaign_data scope to limit your application’s access to a user’s campaign data and to request that the user grant access to that data.
  • OAuth2 API – Content improvements made to the OAuth2 API documentation help to make the process easier to understand and the implementation easier to follow.
  • Delete contacts – You can now successfully DELETE a Contact using the v3 API Reference tester.
  • V3 API User Terms and Conditions – To see content updates made in the V3 API general terms and conditions for usage content, use the links located at the bottom of the My Applications tab.
  • Dev Portal updates - Updates were made to improve the V3 API Developer Portal user experience and documentation.