Our v3 API is now available! Learn more by visiting the v3 developer portal. Creating new v2 API keys is no longer supported.

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

DescriptionTOP

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.

DescriptionTOP

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.

POST: https://api.constantcontact.com/v2/lists

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

Example JSON Request BodyTOP

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

Response CodesTOP

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

StructureTOP

property

type(max length)

description

Example ResponseTOP

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