Contact List Collection

Use this endpoint to retrieve (GET) a collection of existing contact lists, or create (POST) a new contact list. An account can have a maximum of 1000 lists.

Methods:

Click a method to view its documentation

GET POST

Description TOP

Privileges required : contacts:lists:write

Create a new contact list in the user's account, you must include the name of the list, and the list status of ACTIVE, HIDDEN, or REMOVED.

Description TOP

Privileges required : account:update

Add an email address to an account. The email address is added with a status = UNCONFIRMED. Once the verification message sent to the added email address is verified, the status = CONFIRMED. At this point the email address can be used as from_email and reply_to_email address in email campaigns.

NOTE : This endpoint is limited to 200 POST calls per day.

name	type	description
POST: https://api.constantcontact.com/v2/lists
Test API
api_key	query	REQUIRED; The API key for the application

Example JSON Request Body TOP

{
  "name": "Hot Opportunities",
   "status": "ACTIVE"
}

Response Codes TOP

code	description
201	Contact List was successfully created
400	Either JSON was malformed or there was a data validation error
401	Authentication failure
406	Unsupported Accept Header value; must be application/json
409	The contact list name provided is already in use
415	Unsupported content-type in header
500	Internal server error occurred

Structure TOP

property	type (max length)	description

Example Response TOP

{
    "id": "6",
    "name": "Hot Opportunities",
    "status": "ACTIVE",
    "contact_count": 0
}