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.
Click a method to view its documentation
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.
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 |
{ "name": "Hot Opportunities", "status": "ACTIVE" }
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 |
property |
type(max length) |
description |
---|
{ "id": "6", "name": "Hot Opportunities", "status": "ACTIVE", "contact_count": 0 }