Marketing Cloud Engagement has a new model for storing, finding, managing, creating, sharing, and distributing all content-related objects. Access the objects created with the new Content Builder tools using the REST API. Your existing SOAP API integrations only function with the Classic tools.
The Email object represents an email.
- To create or update an Email with PreHeader populated, you need the Email | Content | Email | PreHeaderAccess permission.
- To create or update an Email with ClonedFromID populated, you need the Email | Content | Simple Automated Email | Create From Existing Email permission.
| Name | Data Type | Description |
|---|---|---|
| CategoryID | xsd:int | Specifies the identifier of the folder containing the email. |
| CharacterSet | xsd:string | Indicates encoding used in an email message. Valid values include:
|
| Client | ClientID | Specifies the account ownership and context of an object. |
| ClonedFromID | xsd:int | ID of email message from which the specified email message was created. |
| ContentAreas | ContentArea[] | Contains information on content areas included in an email message. |
| ContentCheckStatus | xsd:string | Indicates whether content validation has completed for this email message. |
| CorrelationID | xsd:string | Identifies correlation of objects across several requests. |
| CreatedDate | xsd:dateTime | Read-only date and time of the object's creation. |
| CustomerKey | xsd:string | User-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object. |
| EmailType | xsd:string | Defines preferred email type. |
| Folder | xsd:string | Specifies folder information (Retrieve only) - Deprecated. |
| HasDynamicSubjectLine | xsd:boolean | Indicates whether email message contains a dynamic subject line. |
| HTMLBody | xsd:string | Contains HTML body of an email message. |
| ID | xsd:int | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID. |
| IsActive | xsd:boolean | Specifies whether the object is active. |
| IsHTMLPaste | xsd:boolean | Indicates whether email message was created via pasted HTML. |
| ModifiedDate | Nullable`1 | Indicates the last time object information was modified. |
| Name | xsd:string | Name of the object or property. |
| ObjectID | xsd:string | System-controlled, read-only text string identifier for object. |
| ObjectState | xsd:string | Reserved for future use. |
| Owner | Owner | Describes account ownership of subscriber in an on-your-behalf account. |
| PartnerKey | xsd:string | Unique identifier provided by partner for an object. This property is accessible only via API. |
| PartnerProperties | APIProperty[] | A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API.Pre |
| PreHeader | xsd:string | Contains text used in preheader of email message on mobile devices. |
| Status | xsd:string | Defines status of object. Status of an address. |
| Subject | xsd:string | Contains subject area information for a message. |
| SyncTextWithHTML | xsd:boolean | Makes the text version of an email contain the same content as the HTML version. |
| TextBody | xsd:string | Contains raw text body of a message. |
| __AdditionalEmailAttribute1 | xsd:string | Optional field that lets you specify up to five email attributes on CREATE or RETRIEVE calls. Used to capture analytics or other metadata. Additional attributes are **AdditionalEmailAttribute 2, **AdditionalEmailAttribute3, and so on. |