A list is a logical collection of contacts in your account. Lists can be managed either entirely internally via your interactive use of the application, with API calls, or you can place them on Webforms and allow contacts to add or remove themselves from lists. You can use lists to collect contacts with similar interests or profiles. Lists, along with Segments and individual contacts, can be used as sending targets for a delivery.

Name Type Description
id string The unique id assigned to the list. You can obtain the id for a list by calling readLists, or by looking at the footer when viewing the overview page for an individual list in the application.
name string The internal name of the list.
label string The external (customer facing) name of the list.
activeCount long The number of active contacts of currently on the list.
status string The status of the list. Valid values are active, deleted, and tmp