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
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 |
|||
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
}