AccountPartner

This object represents a partner relationship between two Account records. An AccountPartner record is created automatically when a Partner record is created for a partner relationship between two accounts.

This object is completely distinct from and independent of Account records that have been enabled for the partner portal.

Note

Supported Calls

create(), delete(), describeLayout()describeSObjects(), query(), retrieve()

Special Access Rules

Customer Portal users can't access this object.

Fields

Field	Details
AccountFromId	Type reference Properties Create, Filter, Group, Sort Description ID of the main Account in the partner relationship.
AccountToId	Type reference Properties Create, Filter, Group, Sort Description ID of the partner Account in the partner relationship.
IsPrimary	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort Description Indicates whether the AccountPartner is the main account’s primary partner (`true`) or not (`false`).
OpportunityId	Type reference Properties Create, Filter, Group, Nillable, Sort Description ID of the opportunity in a partner relationship.
ReversePartnerId	Type reference Properties Filter, Group, Nillable, Sort Description ID of the account in a partner relationship.
Role	Type picklist Properties Create, Filter, Group, Nillable, Sort Description The UserRole that the partner Account has on the main Account. For example, `Consultant` or `Distributor`.

Creating an Account-Account Partner Relationship

When you create a partner relationship between two accounts (when you create a Partner record and specify the AccountFromId), the API automatically creates two AccountPartner records, one for the forward relationship and one for the reverse. For example, if you create a Partner relationship with “Acme, Inc.” as the AccountFromId and “Acme Consulting” as the AccountToId, the API automatically creates two AccountPartner records:

The forward relationship AccountPartner with “Acme, Inc.” as the AccountFromId and “Acme Consulting” as the AccountToId.
The reverse relationship AccountPartner with “Acme Consulting” as the AccountFromId and “Acme, Inc.” as the AccountToId.
The value of the Role field in the reverse relationship AccountPartner is set to the PartnerRole record ReverseRole value associated with the value of the Role field in the forward relationship AccountPartner.

This mapping allows the API to manage the records and their relationships efficiently.

Object Reference for Salesforce and Lightning Platform

AccountPartner

Supported Calls

Special Access Rules

Fields

Creating an Account-Account Partner Relationship

See Also