BuyerGroup

Associates group qualifiers (entitlements, price books, promotions, and shipping methods) with buyer members based on buyer account ID or on the localized language and currency of the market browsed in a webstore. This object is available in API version 57.0; amended to support Market in version 58.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field	Details
Description	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Buyer group details.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record indirectly, for example, through a list view or related record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, and LastReferenceDate is not null, the user accessed this record or list view indirectly.
Name	Type string Properties Create, Filter, Group, idLookup, Sort, Update Description The name of the buyer group.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description ID of the creator of this object. This field is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User
RecordTypeId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the record type of the version This field is a relationship field. Relationship Name RecordType Relationship Type Lookup Refers To RecordType
Role	Type picklist Properties Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Determines a fixed or dynamic relationship to the language and currency that products, promotions, and entitlements are displayed in. Possible values are: `AccountBased` `Market` `DataCloudSegments` The default value is `AccountBased`. When set to `Market`, and when the org has multiple locales, the currency and language for qualifiers (price books, promotions, entitlements) dynamically change as the buyer views different locale-based markets.

Usage

BuyerGroup is related to objects that enable a localized buyer experience. Together, these objects provide buyers with dynamic access to the qualifiers (entitlements, price books, and promotions) associated with their buyer group when they browse and shop in webstores with localized languages and currencies. The related objects are as follows:

BuyerGroup - stores keys that link member entitlements, price books, promotions, and shipping methods to either a single currency and language or to multiple currencies and languages.
BuyerCriteria - represents locales (languages and currencies) that are enabled for BuyerGroup members when they shop in webstores with localized currencies and languages.
BuyerGroupBuyerCriteria - associates a buyer group that is enabled for webstores with multiple languages and currencies with BuyerCriteria that define those languages and currencies.
BuyerGroupRelatedObject - allows BuyerGroup qualifiers (entitlements, price books, and promotions) to be available in multiple languages and currencies without duplicating the qualifiers for each language and currency.

Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

BuyerGroupChangeEvent: Change events are available for the object.
BuyerGroupFeed: Feed tracking is available for the object.
BuyerGroupHistory: History is available for tracked fields of the object.
BuyerGroupOwnerSharingRule: Sharing rules are available for the object.
BuyerGroupShare: Sharing is available for the object.

Login

Products

Experiences

Agentforce

Data Cloud

Agentforce & AI App Development

Discover the #1 AI CRM

Salesforce Platform

Artificial Intelligence

Sales

Service

Marketing

Commerce

Tableau

MuleSoft

Slack

Net Zero

Small Business

Partner Apps & Experts

Customer Success

Heroku

Discover the #1 AI CRM

Discover the #1 AI CRM

Automotive

Communications

Engineering, Construction, & Real Estate

Consumer Goods

Education

Energy & Utilities

Financial Services

Healthcare & Life Sciences

Manufacturing

Media

Nonprofit

Professional Services

Public Sector

Retail

Technology

Travel, Transportation & Hospitality

Explore Salesforce for industries.

Explore Salesforce for industries.

Customer Stories

Salesforce on Salesforce Stories

Trailblazer Stories

Explore success stories.

Explore success stories.

Learning on Trailhead

Events

Blogs

By Topic

By Role

By Industry

By Content Type

Become a Trailblazer.

Become a Trailblazer.

Help & Documentation

Communities

Services & Plans

Your Account

Questions? We can help.

Questions? We can help.

About Salesforce

Our Values

Our Impact

Careers

Newsroom

Legal

More Salesforce Brands

Hear our story.

Hear our story.

Events

Original Series

My List

Explore Salesforce+.

Explore Salesforce+.

Login

Products

Experiences

Contact Us

By phone