{"title":"Customer and account objects","slug":"customer-and-account-objects","url":"https://support.storeconnect.com/articles/customer-and-account-objects","url_markdown":"https://support.storeconnect.com/articles/customer-and-account-objects.md","subtitle":null,"summary":"The Salesforce objects behind customers and their entitlements: accounts, contacts, addresses, memberships, account credit, loyalty points, restricted product approvals, and sign-in providers. Use it to find the right object before you query customer data.","type":"Developer_Documentation","video_url":"","keywords":"customer objects, account, contact, address, membership, account credit, account credit ledger, account points, loyalty, permitted restricted product, authentication provider, store role, data model, salesforce schema","last_modified":"2026-09-15T02:32:04+0000","body_markdown":"Customers use the two standard Salesforce objects, not custom ones, and\neverything StoreConnect adds hangs off them. Use this article to find the object\nyou need before you query customer data.\n\n## Account and contact, and which is which\n\nAn [Account](account-object-reference) is the organization or household. A\n[Contact](contact-object-reference) is a person, and it is the record a storefront\nshopper signs in as.\n\nThis matters more in StoreConnect than in a plain Salesforce org, because\n**Account** is reused for several roles beyond customers. The same object holds\nsuppliers, and brands are accounts with a flag set. So filtering customers means\nfiltering on the fields that say what kind of account it is, not just querying\nevery account.\n\nBoth records are also reused on the storefront under different names: **Account**\nis rendered by three Liquid objects, one of which is **Brand**. Each object\nreference names them in its **On the storefront** section.\n\n## Entitlements are records, not flags\n\nWhat a customer is allowed to do, or has been given, is stored as separate\nrecords rather than checkboxes. That is what makes the balances auditable.\n\n- **Credit.** [Account Credit](account-credit-object-reference) holds a balance,\n  and every movement is an\n  [Account Credit Ledger](account-credit-ledger-object-reference) entry. The\n  balance is the sum of the ledger, so never edit it as a figure.\n- **Points.** [Account Points Ledger](account-points-ledger-object-reference)\n  works the same way for loyalty points.\n- **Membership.** A [Membership](membership-object-reference) grants access, and\n  gates content through\n  [Membership Page](membership-page-object-reference) and\n  [Membership Article](membership-article-object-reference).\n- **Approvals.** Restricted products need\n  [Permitted Restricted Product](permitted-restricted-product-object-reference)\n  for the account, listing approved\n  [items](permitted-restricted-item-object-reference).\n- **Scoped catalogs.**\n  [Account Product Category](account-product-category-object-reference) limits an\n  account to particular categories, so different customers see different catalogs.\n\n## Objects in this domain\n\n| Object | API name | Purpose |\n|--------|----------|---------|\n| [Account](account-object-reference) | `Account` | The standard Salesforce account, used for customers, companies, suppliers, and brands |\n| [Contact](contact-object-reference) | `Contact` | A person. The record a storefront shopper signs in as |\n| [Address](address-object-reference) | `s_c__Address__c` | A stored address belonging to an account or contact |\n| [Account Credit](account-credit-object-reference) | `s_c__Account_Credit__c` | A credit balance held by an account, spendable at checkout |\n| [Account Credit Ledger](account-credit-ledger-object-reference) | `s_c__Account_Credit_Ledger__c` | An entry for every change to an account credit balance |\n| [Account Points Ledger](account-points-ledger-object-reference) | `s_c__Account_Points_Ledger__c` | An entry for every change to an account's loyalty points |\n| [Account Product Category](account-product-category-object-reference) | `s_c__Account_Product_Category__c` | Limits an account to particular categories, for scoped catalogs |\n| [Membership](membership-object-reference) | `s_c__Membership__c` | A paid or granted membership, and what it entitles the holder to |\n| [Membership Page](membership-page-object-reference) | `s_c__Membership_Page__c` | Restricts a page to members |\n| [Membership Article](membership-article-object-reference) | `s_c__Membership_Article__c` | Restricts an article to members |\n| [Permitted Restricted Product](permitted-restricted-product-object-reference) | `s_c__Permitted_Restricted_Product__c` | Approves an account to buy a restricted product |\n| [Permitted Restricted Item](permitted-restricted-item-object-reference) | `s_c__Permitted_Restricted_Item__c` | One approved item within a restricted-product approval |\n| [Authentication Provider](authentication-provider-object-reference) | `s_c__Authentication_Provider__c` | An external sign-in provider and its configuration |\n| [Store User Role](store-user-role-object-reference) | `s_c__Store_User_Role__c` | Assigns a store role to a user |\n| [User](user-object-reference) | `User` | The standard Salesforce user. Staff, including POS operators |\n| [Compliance Group](compliance-group-object-reference) | `s_c__Compliance_Group__c` | A group used to apply compliance rules to accounts or products |\n\n## Where it meets other domains\n\n- **Orders and checkout.** Orders belong to an account and a contact, and credit\n  and vouchers are spent through payments. See\n  [order and checkout objects](order-and-checkout-objects).\n- **Catalog.** Account pricing runs through a\n  [price book](pricebook2-object-reference), and scoped catalogs through account\n  categories. See [catalog objects](catalog-objects).\n- **Store design.** Memberships gate pages and articles. See\n  [store design objects](store-design-objects).\n- **Point of sale.** POS operators are [users](user-object-reference) granted\n  access per outlet. See [POS objects](pos-objects)."}