--- schema_version: "1" id: 231347b3c55ee843a0eb6c43a80a718999c8d23c50d4d90768d2caa6ecc9e594 title: Account collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/account.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/account.html source_site: developer.salesforce.com content_type: documentation content_hash: cb28e2e391e543c9754f29b69d9974f5982422ebe87e69f9c15ad7cd46c591d8 products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # Account Represents a Marketing Cloud Engagement account. - To create or update Account subscription data, you need the **Administration | Account | Subscription** permission. - To create or update Account private label data, you need the **Administration | Account | Private Labels** permission. - To create or update Account business rule data, you need the **Administration | Account | Business Rules** permission. - To create or update Account role data, you need the **Administration | Business Units | Manage Roles** permission. ## Using the Account Object If the authenticated user exists in a Reseller or Enterprise account and there are more subaccounts available, you can create an `Account` object. If the authenticated user is a Core account, you can retrieve object attributes. ## Retrieving an Account Object Retrieve an account by its `ID` or `PartnerKey`. Use filters to further refine the results, if necessary. ## Embedded Partner Usage For Embedded partners, use the `PartnerKey` property to associate an external identifier with the account. You can’t change the `PartnerKey` after the Account is created, so we recommend using `CustomerKey` instead. ## Properties | Name | Data Type | Description | | ------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `AccountType` | [AccountTypeEnum](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/accounttypeenum.md) | The type of Marketing Cloud Engagement account. | | `AccountUsers` | Array of [AccountUser](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/accountuser.md) objects | An array of users associated with a specific account. | | `Address` | String | The street address associated with the account. | | `BrandID` | Int | The brand tags associated with the account. | | `BusinessName` | String | The business name associated with an account. | | `BusinessRules` | Array of BusinessRule objects | Not used. | | `Children` | Array of [AccountDataItem](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/accountdataitem.md) objects | An array of AccountDataItem objects that represent child accounts of this account. | | `City` | String | The city associated with the account. | | `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. | | `Country` | String | The country associated with the account. | | `CreatedDate` | DateTime | The date and time when the account was created. | | `CustomerID` | Long | Not used. | | `CustomerKey` | String | A user-supplied unique identifier for the account. | | `DBID` | Int | Not used. | | `DeletedDate` | DateTime | The date and time of an account’s deletion. The value of this property must be set before the account can be deleted. | | `EditionID` | Int | Specifies the product edition of the account. | | `Email` | String | The email address associated with the account. | | `Fax` | String | The fax number associated with the account. | | `FromName` | String | Specifies the default email message From Name. Deprecated for email send definitions and triggered send definitions. | | `ID` | Int | Read-only identifier for an object. Some objects use the ObjectID property as a unique ID. | | `InheritAddress` | Boolean | Specifies that an Enterprise 2.0 business unit inherits the address from the parent business unit. | | `IsActive` | Int | Specifies whether the account is active. | | `IsTestAccount` | Boolean | Specifies whether an account is a test account. | | `IsTrialAccount` | Boolean | Not used. | | `LanguageLocale` | [Locale](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/locale.md) object | Defines the language preferences associated with the account. | | `Locale` | [Locale](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/locale.md) object | Contains the locale information for the account. The default value is `en-US`. | | `ModifiedDate` | DateTime | The date and time when the account was last modified. | | `Name` | String | The name of the account. | | `ObjectID` | String | System-controlled, read-only text string identifier for object. | | `ObjectState` | String | Not used. | | `OrgID` | Int | Parent account ID for On-Your-Behalf or Lock-and-Publish accounts. | | `Owner` | [Owner](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/owner.md) object | Describes the ownership the account in an on-your-behalf account. | | `ParentAccount` | [Account](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/account.md) object | Provides information about the parent account. | | `ParentID` | Int | The ID of the parent account for Lock and Publish, On Your Behalf, Enterprise, and Enterprise 2.0 account children and business units. | | `ParentName` | String | The name of the Parent account. | | `PartnerKey` | String | A 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. | | `Phone` | String | The phone number associated with the account. | | `PrivateLabelID` | Int | The private label ID for the account. | | `PrivateLabels` | Array of [PrivateLabel](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/privatelabel.md) objects | Specifies UI modifications to use on child accounts. | | `ReportingParentID` | Int | Not used. | | `Roles` | Array of [Role](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/role.md) objects | Collection of roles defined for an account. | | `State` | String | The state or region associated with the account. | | `Subscription` | [Subscription](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/subscription.md) object | Contains information about the subscriptions that apply to the account. | | `TimeZone` | [TimeZone](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/timezone.md) object | Contains time zone information for the account. For Create and Update calls, this property defines the time zone for an Account object. In a Retrieve call, TimeZone indicates which time zone is in effect for the Account object in question. Without a specific time zone, the Account defaults to Central Standard Time. | | `Zip` | String | The ZIP code associated with the account. | ## Related Items - [Supported Operations for Objects and Methods](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/supported_operations_for_objects_and_methods.md) - [Create an Agency Client Object](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/creating_an_agency_client_object.md) - [Manage Enterprise 2.0 Accounts](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/managing_enterprise_20_accounts_with_the_web_services_api.md) - [Retrieve Account Object Using the CustomerKey Attribute](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_account_object_using_the_partnerkey_attribute.md)