--- schema_version: "1" id: 0691ea0b9b2ce28fbf349e7247f50720c06424478ddca573ff0771be6375cbf8 title: Email collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/email.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/email.html source_site: developer.salesforce.com content_type: documentation content_hash: 60d19a9cb712ddf144b634e091fb08d4c40438fde01eea15eb0ce66209897c9c products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # Email An object that represents a classic email in Email Studio. **note:** To manage Content Builder emails, use the [Assets endpoints in REST API](/docs/marketing/marketing-cloud/references/mc_rest_assets). ## Properties | Name | Data Type | Description | | ----------------------------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `CategoryID` | Int | Specifies the identifier of the folder containing the email. | | `CharacterSet` | String | Indicates encoding used in an email message. Valid values include: | | `Client` | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) object | Specifies the account ownership and context of an object. | | `ClonedFromID` | Int | ID of email message from which the specified email message was created. | | `ContentAreas` | Array of objects | Contains information about content areas included in an email message. | | `ContentCheckStatus` | String | Indicates whether content validation has completed for this email message. | | `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. | | `EmailType` | [EmailType](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/emailtype.md) | Indicates whether the email contains HTML or plain text. | | `Folder` | String | Specifies folder information (Retrieve only) - Deprecated. | | `HasDynamicSubjectLine` | Boolean | Indicates whether email message contains a dynamic subject line. | | `HTMLBody` | String | Contains HTML body of an email message. | | `ID` | Int | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID. | | `IsActive` | Boolean | Specifies whether the object is active. | | `IsHTMLPaste` | Boolean | Indicates whether email message was created via pasted HTML. | | `ModifiedDate` | DateTime | The date and time when the object was last modified. | | `Name` | String | Name of the object or property. | | `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 by using the API. | | `PreHeader` | String | Contains text used in preheader of email message on mobile devices. | | `Status` | String | Defines status of object. Status of an address. | | `Subject` | String | Contains subject area information for a message. | | `SyncTextWithHTML` | Boolean | Makes the text version of an email contain the same content as the HTML version. | | `TextBody` | String | Contains raw text body of a message. | | `__AdditionalEmailAttribute1` | String | Optional field that lets you specify up to five email attributes in `CREATE` or `RETRIEVE` calls. Used to capture analytics or other metadata. Additional attributes are `AdditionalEmailAttribute2`, `AdditionalEmailAttribute3`, and so on. | ## Related Items - [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md) - _Salesforce Help_: [Personalization Strings in Email Studio](https://help.salesforce.com/articleView?id=mktg.mc_es_available_personalization_strings.htm) - [Create a Text-Only Email](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_a_text_only_email_via_the_web_service_api.md) - [Create a Triggered Send Email Campaign Workflow](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_a_triggered_email_campaign_workflow.md) - [Create an Email](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_an_email_via_the_web_service_api.md) - [Assets Endpoints (REST API)](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_assets)