--- schema_version: "1" id: 7a7c71b837d93381afeab367bfdc3fddf8db529afb89cb8712efe6a6cd5a8e5d title: List collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/list.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/list.html source_site: developer.salesforce.com content_type: documentation content_hash: 34f457bb93c909931b23af412d922cf1e93b625d92df6e2ce2aae9bd6d0221b3 products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # List Defines a list of subscribers. ## Properties | Name | Data Type | Description | | -------------------- | --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `AutomatedEmail` | [Email](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/email.md) object | Specifies email to send upon a subscriber joining a list. This property corresponds to the Welcome Email functionality. | | `Category` | Int | ID of the folder that an item is located in. | | `Client` | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) object | Specifies the account ownership and context of an object. | | `CorrelationID` | String | Identifies correlation of objects across several requests. | | `CreatedDate` | DateTime | The date and time when the object was created. | | `CustomerKey` | String | User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object. | | `Description` | String | Describes and provides information regarding the object. | | `ID` | Int | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID. | | `ListClassification` | [ListClassificationEnum](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/listclassificationenum.md) | Specifies the classification for a list. Valid values include: | | `ListName` | String | Name of a specific list. | | `ModifiedDate` | DateTime | The date and time when the object was last modified. | | `ObjectID` | String | System-controlled, read-only text string identifier for object. | | `ObjectState` | String | Not used. | | `Owner` | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md) object | Describes account ownership of subscriber in an on-your-behalf account. | | `PartnerKey` | String | Unique identifier provided by partner for an object. This property is accessible only via API. | | `PartnerProperties` | Array of [APIProperty](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiproperty.md) objects | A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API. | | `SendClassification` | [SendClassification](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/sendclassification.md) object | Indicates the send classification to use as part of a send definition. | | `Subscribers` | Array of [Subscriber](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscriber.md) objects | Indicates subscribers associated with an object. | | `Type` | [ListTypeEnum](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/listtypeenum.md) | Indicates type of specific list. Valid values include Public, Private, Salesforce, GlobalUnsubscribe, and Master. Indicates the type of email to send to the address. Valid values include Text and HTML. | ## Use Cases - [Create a List](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_a_list.md) - [Create a List-Based Email Send Workflow](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_a_list_based_email_send_workflow.md) ## Related Items - [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)