BusinessUnit

The BusinessUnit object represents a unit within an Enterprise or Enterprise 2.0 account. To create or update business unit roles, you must have the Administration | Business Units | Manage Roles permission. To create or update a BusinessUnit subscriber filter, you must have the Administration | Business Units | Define Subscriber Filter permission.

NameData TypeDescription
AccountTypeAccountTypeEnumType of Marketing Cloud Engagement account. Valid values include:
  • None
  • EXACTTARGET
  • PRO_CONNECT
  • CHANNEL_CONNECT
  • CONNECT
  • PRO_CONNECT_CLIENT
  • LP_MEMBER
  • DOTO_MEMBER
  • ENTERPRISE_2
  • BUSINESS_UNIT
AccountUsersArray of AccountUser objectsAn array of users associated with a specific account.
AddressStringThe physical mailing address required at the bottom of all email messages contains the information described by this property (no P.O. Boxes). The address used to communicate with a Person.
BrandIDIntSpecifies brand tags to use on an account.
BusinessNameStringBusiness name of an account's owner.
BusinessRulesArray of BusinessRule objectsNot used.
ChildrenArray of AccountDataItem objectsAn array of AccountDataItem objects that represent child accounts of this account.
CityStringCity of an account's owner to be displayedin thephysical mailing address required at the bottom of all email messages.
ClientClientID objectSpecifies the account ownership and context of an object.
CorrelationIDStringIdentifies correlation of objects across several requests.
CountryStringCountry of an account's owner, as displayed in the physical mailing address required at the bottom of all email messages.
CreatedDateDateTimeThe date and time when the object was created.
CustomerIDLongNot used.
CustomerKeyStringUser-supplied unique identifier for an object within an object type. This property corresponds to the external key assigned to an object.
DBIDIntNot used.
DefaultHomePageLandingPageDefines default landing page for business unit to use as home page.
DefaultSendClassificationSendClassification objectDefines default send classification for all sends from a specific business unit.
DeletedDateDateTimeRead-only date and time of an account's deletion (the value of this property must be set before the account can be deleted).
DescriptionStringDescribes and provides information regarding the object.
EditionIDIntSpecifies the product edition of the account. Valid values include:
  • 2 Core
  • 3 Advanced
  • 4 Enterprise
  • 5 On Your Behalf
  • 6 Lock & Publish
  • 7 Business Unit
  • 8 Agency
  • 9 Embedded
  • 10 Enterprise 2.0
  • 11 Enterprise 2.0 Business Unit
EmailStringDefault email address for object. Indicates if subscriber information can be used for email sends.
FaxStringFax number of the account's owner.
FromNameStringSpecifies the default email message From Name. Deprecated for email send definitions and triggered send definitions.
IDIntRead-only identifier for an object. Some objects use the ObjectID property as a unique ID.
InheritAddressBooleanSpecifies that an Enterprise 2.0 business unit inherits the address from the parent business unit.
IsActiveIntSpecifies whether the object is active.
IsTestAccountBooleanSpecifies whether an account is a "Test" account.
IsTrialAccountBooleanNot used.
LanguageLocaleLocale objectDefines language preferences associated with a account, business unit, or user.
LocaleLocale objectContains the locale information for an Account. If no location is set, Locale defaults to en-US.
MasterUnsubscribeBehaviorUnsubscribeBehaviorEnumDefines how master unsubscription requests are handled for a business unit.Valid values include ENTIRE_ENTERPRISE or BUSINESS_UNIT_ONLY.
ModifiedDateDateTimeThe date and time when the object was last modified.
NameStringName of the object or property.
ObjectIDStringSystem-controlled, read-only text string identifier for object.
ObjectStateStringNot used.
OrgIDIntParent account ID for On-Your-Behalf or Lock-and-Publish accounts.
OwnerOwner objectDescribes account ownership of subscriber in an on-your-behalf account.
ParentAccountAccount objectProvides more information regarding the parent account.
ParentIDIntSpecifies thethe ID number of the parent account for Lock and Publish, On Your Behalf, Enterprise, and Enterprise 2.0 account children and business units.
ParentNameStringSpecifies the name of the Parent account.
PartnerKeyStringUnique identifier provided by partner for an object. This property is accessible only via API.
PartnerPropertiesArray of APIProperty objectsA collection of metadata supplied by the client and stored by the system. These properties are accessible only via API.
PhoneStringSpecifies a phone number. Specifies the phone number of the account owner. Specifies the Phone data type.
PrivateLabelIDIntSpecifies the private label for an account.
PrivateLabelsArray of PrivateLabel objectsSpecifies UI modifications to use on child accounts.
ReportingParentIDIntNot used.
RolesArray of Role objectsCollection of roles defined for an account.
StateStringSpecifies the geographical state of the account's owner. The physical mailing address required at the bottom of all email messages contains the information described by this property.
SubscriberFilterFilterPart objectDefines filter used to assign subscribers to a specific business unit within an Enterprise or Enterprise 2.0 structure.
SubscriptionSubscription objectNot used.
TimeZoneTimeZone objectContains time zone information for an Account. For Create and Update calls, this property defines the time zone for an Account object. On 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.
ZipStringSpecifies the zip code of the account's owner. The physical mailing address required at the bottom of all email messages contains the information described by this property.