Our v3 API is now available! Learn more by visiting the v3 developer portal.

Individual Contact List

Use this endpoint to retrieve (GET), update (PUT), or delete (DELETE) a contact list. To create a new contact list, use the POST method for the Contact List Collection.

Methods:

Click a method to view its documentation

GET PUT DELETE

DescriptionTOP

Privileges required: contacts:lists:write

PUT: Update the name, status of the ContactList specified by the listId path parameter. Performing a PUT overwrites all existing properties for the contactlist resource; any properties left blank or not included in the call will delete those property values prior to the call.

DescriptionTOP

Privileges required: mylibrary:folder:update

Use PUT to modify the following properties for a folder specified by folderId path parameter:

  • update the folder's name
  • change the folder's location in the directory structure by changing it's parent_id
    To move a folder to level 1 in the directory structure, set the parent_id to 0

DescriptionTOP

Privileges required: mylibrary:file:update

Use a PUT call to update the following for a file (specified using the fileId path parameter):

  • Update the name
  • Update the description
  • Move a file to another folder, using folder_id to specify the destination folder.

DescriptionTOP

Privileges required: campaign:write

Update an existing event by using the eventId path parameter. 

DescriptionTOP

Privileges required: campaign:write

Update an existing event item; specify the event and the item using the eventId and itemId path parameters.

DescriptionTOP

Privileges required: campaign:write

Update an existing promocode for an event; specify the code and event using the eventId and promocodeId path parameters.

DescriptionTOP

Privileges required: campaign:write

Update an existing fee (specify using feeId) for an event specified by eventId.

DescriptionTOP

Privileges required: campaign:write

Update an existing item attribute by specifying the eventId, itemId, and attributeId path parameters. Include the attribute name and description in the JSON request body. 

NOTE: You cannot change an attribute name once any have been sold to or claimed by event registrants.

DescriptionTOP

Privileges required: campaign:activate

Update the schedule for an email campaign using the scheduleId and campaignId path parameters.

DescriptionTOP

Privileges required: campaign:create

Update an existing email campaign message specified by the campaignId path parameter. For campaigns with a template_type = CUSTOM, all editable fields are available for updating. If template_type = STOCK, the following fields are not available for edit (read-only):

  • text_content
  • email_content
  • style_sheet

These fields can only be updated using the Constant Contact user interface.

NOTE: There are several campaign properties that are optional by default, but become REQUIRED once another property is used. See Structure table below for specific properties.

PUT: https://api.constantcontact.com/v2/lists/{listId}

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

listId

path

Specifies the contact list to modify

Example JSON Request BodyTOP

	{
		"name": "Usefull Tips & Tricks!",
		"status": "ACTIVE"
	}

Response CodesTOP

code

description

200

Request was successful, contact list updated

401

Authentication failure

404

Contact list not found

406

Unsupported accept header value, must be application/json

415

Unsupported content-type in the header, use application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

{
    "id": "4",
    "name": "Useful Tips & Tricks!",
    "status": "ACTIVE",
    "created_date": "2013-04-23T15:07:40.000Z",
    "modified_date": "2013-04-23T15:13:43.000Z",
    "contact_count": 390
}