PardotTenant

Represents an Account Engagement business unit.

Use available SOAP calls to create new business units, and query and update information in existing business units.

Pardot is now known as Marketing Cloud Account Engagement. We wish we could snap our fingers to update the name everywhere, but you can expect to see the previous name in a few places, including API names and developer resources.

Note

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Version 

Introduced in API version 44.0.

Supported SOAP API Calls 

create(), describeSObjects(), query(), retrieve(), update(), upsert()

Supported REST API Methods 

GET, HEAD, PATCH, POST, Query

Special Access Rules 

• PardotTenant is available to customers with any Account Engagement edition.

Fields 

CdpEnablementStatus 

• Type: staticenum
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 58.0

ConsentAlignmentStatus 

• Type: staticenum
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 64.0

ContentConvergenceWorkspace 

• Type: text
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 61.0

CreationStatus 

• Type: staticenum

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 44.0

• Description: The operational status of the business unit managed by Account Engagement.

The default value is Creating.

DataSpaceApiName 

• Type: text
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 65.0

DeleteOn 

• Type: dateonly
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 44.0

DeveloperName 

• Type: string

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: Universally unique identifier for this object. If an object does not provide a value for this field on INSERT, a value will be auto-generated for it.

InitialPardotAdminId 

• Type: ID

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 44.0

• Description: The Salesforce user who set up the business unit.

This field is a relationship field.

IsContentConvergenceEnabled 

• Type: boolean
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 61.0

IsEinsteinAssistantEnabled 

• Type: boolean
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 60.0

Language 

• Type: string

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The language of the business unit.

MasterLabel 

• Type: string

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Description: The name of the Account Engagement business unit. This field syncs with the PardotTenantName field.

PardotGdotTenantKey 

• Type: text
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 50.0

PardotTenantAccountType 

• Type: staticenum
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 48.0

PardotTenantEnvironment 

• Type: staticenum
• Required: No
• Properties: Filter, Group, Nillable, Sort
• Introduced: API version 48.0

PardotTenantId 

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 44.0

• Description: The numerical identifier for the business unit.

PardotTenantName 

• Type: text

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 45.0

• Description: The name of the Account Engagement business unit. This field syncs with the MasterLabel field.

PardotTenantStatusCode 

• Type: staticenum

• Required: No

• Properties: Filter, Group, Nillable, Sort

• Introduced: API version 49.0

• Description: The operational status of the business unit.

Usage 

To create an Account Engagement business unit, set a valid user ID for the InitialPardotAdminID field and a value for PardotTenantName. If you have multiple business units, the PardotTenantName value must be unique.

To verify the status of a business unit, query the PardotTenantID. A return value of CREATING means the business unit is being created. A return value of CREATED means the business unit has been created.

Update capabilities are limited to changing the PardotTenantName field and deleting a business unit if an error occurs upon creation. To delete the PardotTenant, one of these scenarios must be true:

• The CreationStatus has a value of ERROR.
• The CreationStatus has a value of CREATING, UPDATING, or DELETING, and the system hasn’t updated the tenant in the last hour.