Contact Lists

POST (create) a List

Changed on

Create a new contact list resource

post/contact_lists

Request

  • Base URL
    https://api.cc.email/v3
  • URL
    https://api.cc.email/v3/contact_lists
  • Auth
    • OAuth 2
      Implicit: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Scopes: contact_data
    • or OAuth 2
      Authorization code: https://authz.constantcontact.com/oauth2/default/v1/authorize
      Token URL: https://authz.constantcontact.com/oauth2/default/v1/token scopes: contact_data

Request body

namestring required

The name given to the contact list

favoriteboolean

Identifies whether or not the account has favorited the contact list.

descriptionstring

Text describing the list.

Example request

{
  "name": "Multiple purchases",
  "favorite": true,
  "description": "List of repeat customers"
}

Response

New list successfully created

list_idstring uuid required

Unique ID for the contact list

namestring required

The name given to the contact list

descriptionstring

Text describing the list.

favoriteboolean

Identifies whether or not the account has favorited the contact list.

created_atstring date-time

System generated date and time that the resource was created, in ISO-8601 format.

updated_atstring date-time

Date and time that the list was last updated, in ISO-8601 format. System generated.

deleted_atstring date-time

If the list was deleted, this property shows the date and time it was deleted, in ISO-8601 format. System generated.

Example response

{
  "list_id": "06526938-56dd-11e9-932a-fa163ea075fa",
  "name": "Multiple purchases",
  "description": "List of repeat customers.",
  "created_at": "2016-01-23T13:48:44.108Z",
  "updated_at": "2016-03-03T10:56:29-05:00",
  "deleted_at": "2016-03-03T10:56:29-05:00"
}

Changes