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

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.

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

contact_count

integer

The number of contacts in the list (Read Only)

created_date

string

Time stamp indicating when the contact list was created, in ISO-8601 format (Read Only)

id

string

Unique ID for each contact list (Read Only)

list_id

string

The uuid formatted unique identifier used to identify the list in the V3 API. Useful for migrating V2 API integrations to the V3 API. (Read Only)

modified_date

string

Time stamp indicating when the contact list was last modified, in ISO-8601 format (Read Only)

name

string (255)

REQUIRED. Contact list name

status

string

REQUIRED. The contact list status, valid values are:

  • ACTIVE - the list is visible to contacts to join, and visible to Constant Contact users
  • HIDDEN - list is not visible to contacts, but it is visible to Constant Contact users

Example ResponseTOP

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