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
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.
|
POST: https://api.constantcontact.com/v2/lists |
|||
|
name |
type |
default |
description |
|---|---|---|---|
|
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
}