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:read

Retrieves a list of the contacts in the contact list specified using the listId path parameter. Use the modified_since query parameter to retrieve only contacts in the list that have been modified on or after the date/time specified; this is useful for syncing contact lists across applications.

DescriptionTOP

Privileges required: contacts:lists:read

GET a specific contact list (specified using the listId path parameter).

DescriptionTOP

Privileges required: contacts:lists:read

Retrieves a list of the contact lists in the user's account. Use the modified_since query parameter to retrieve only contacts lists that have been modified on or after the date/time specified; this is useful for identifying and synching lists that have changed between applications.

DescriptionTOP

Privileges required: account:read

Retrieve a list of all email addresses associated with an account. Constant Contact accounts are required have at least one CONFIRMED email address in order to send email marketing campaigns.

You can retrieve email addresses by status, CONFIRMED or UNCONFIRMED,  using the status query parameter.

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

Test API

name

type

default

description

api_key

query

REQUIRED; The API key for the application

include_list_id

query

false

Boolean; include_list_id=true returns the uuid formatted list_id property, which is the list unique identifier in the V3 API. Useful for migrating V2 API integrations to the V3 API.

modified_since

query

Use this parameter to retrieve only the contact lists that have been modified on or after the date/time specified in ISO-8601 format.

Response CodesTOP

code

description

200

Request was successful

401

Authentication failure

404

ContactList not found for specified ID

406

Unsupported Accept Header value, must be application/json

500

Internal server error occurred

StructureTOP

property

type(max length)

description

Example ResponseTOP

[
    {
        "id": "1",
        "list_id":"12345678-1234-1234-1234-123456789012",
        "name": "General Interest",
        "status": "ACTIVE",
        "created_date": "2013-03-11T20:37:28.000Z",
        "modified_date": "2013-03-11T20:41:42.000Z",        
        "contact_count": 143
    },
    {
        "id": "2",
        "list_id":"12345678-1234-1234-1234-123456789012",
        "name": "Great News!",
        "status": "ACTIVE",
        "created_date": "2012-12-19T21:33:22.000Z",
        "modified_date": "2013-02-01T17:54:43.000Z",        
        "contact_count": 53
    },
    {
        "id": "3",
        "list_id":"12345678-1234-1234-1234-123456789012",
        "name": "Monthly Specials!",
        "status": "ACTIVE",
        "created_date": "2012-12-19T21:33:50.000Z",
        "modified_date": "2013-02-01T17:54:43.000Z",
        "contact_count": 375
    },
    {
        "id": "4",
        "list_id":"12345678-1234-1234-1234-123456789012",
        "name": "Tips, Tricks, & Fun!",
        "status": "HIDDEN",
        "created_date": "2012-12-19T21:33:50.000Z",
        "modified_date": "2013-02-01T17:54:43.000Z",
        "contact_count": 2
    }
    
]