# List

Defines a list of subscribers.

## Properties

| Name                 | Data Type                                                                                 | Description                                                                                                                                                                                               |
| -------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AutomatedEmail`     | [Email](/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](/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](/docs/marketing/marketing-cloud/guide/listclassificationenum.md) | Specifies the classification for a list. Valid values include:<ul><li>ExactTargetList</li><li>PublicationList</li><li>SuppressionList</li></ul>                                                           |
| `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](/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](/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](/docs/marketing/marketing-cloud/guide/sendclassification.md) object  | Indicates the send classification to use as part of a send definition.                                                                                                                                    |
| `Subscribers`        | Array of [Subscriber](/docs/marketing/marketing-cloud/guide/subscriber.md) objects        | Indicates subscribers associated with an object.                                                                                                                                                          |
| `Type`               | [ListTypeEnum](/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](/docs/marketing/marketing-cloud/guide/creating_a_list.md)
- [Create a List-Based Email Send Workflow](/docs/marketing/marketing-cloud/guide/creating_a_list_based_email_send_workflow.md)

## Related Items

- [Supported Operations for Objects and Methods](/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md)