{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Person Accounts"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"person-accounts","__idx":0},"children":["Person Accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Onboarded™ application supports Salesforce Person Accounts for organizations that use them. Person Accounts merge the Account and Contact objects into a single record type stored in the Account object."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Are Person Accounts?"]}," Person Accounts are a Salesforce feature (enabled via B2C license) where individual people are represented as Account records with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount = true"]},". Fields like FirstName, LastName, and PersonEmail are available directly on the Account object."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-account-detection","__idx":1},"children":["Person Account Detection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you open the Onboarded™ Setup tab and navigate to Object Configuration, the application automatically checks if Person Accounts are enabled in your org using the following process:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Check:"]}," It looks for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field on the Account object. This field only exists when Person Accounts are enabled in the org"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field exists → Person Accounts are enabled → \"Person Account\" option appears in Employee object dropdown"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field does NOT exist → Person Accounts are disabled → \"Person Account\" option does NOT appear"]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," The detection happens dynamically each time you load the Object Configuration tab. If you enable Person Accounts in your org after installing the Onboarded™ app, simply refresh the Onboarded™ Setup tab to see the \"Person Account\" option appear."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-account-mapping-setup","__idx":2},"children":["Person Account Mapping Setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Navigate to Onboarded™ Setup."]}," From the Salesforce App Launcher, select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Onboarded™ Setup"]}," tab. ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Note: You must have the \"Onboarded™ Admin\" permission set assigned to see this tab."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click Object Configuration Tab."]}," In the Onboarded™ Setup interface, click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Object Configuration"]}," tab (second tab from left). ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["This tab displays a list of Onboarded™ entities (Employee, Employer, Client, etc.) with object selectors for each."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Locate the Employee Entity Row."]}," Find the row labeled ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Employee\""]}," in the entity list. This is typically the first row in the Object Configuration table."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click Edit Button."]}," Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," button (pencil icon) next to the Employee object dropdown. This unlocks the dropdown for editing."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Select \"Account\" from Dropdown."]}," Click the Salesforce Object dropdown (now enabled) and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Account\""]}," from the list of available objects."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Why Account?"]}," Person Accounts are stored in the Account object with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount = true"]},". Selecting \"Account\" tells the application to query Account records for Employee data."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person Account Detection Modal Appears."]}," After selecting \"Account\", the application automatically detects that Person Accounts are enabled in your org and displays a modal dialog asking:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Person Accounts are available in your org. Would you like to map Employees to Person Accounts?\""]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes:"]}," Configure Employee to use Person Account fields (PersonEmail, PersonPhone, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No:"]}," Keep Employee mapped to standard Business Account fields"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What This Modal Means:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The application detected ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field exists on Account object"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You selected \"Account\" for Employee, which could mean either Business Accounts or Person Accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This modal clarifies which type of Account records you want to use for Employees"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click \"Yes\" to Enable Person Account Mode."]}," Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Yes\""]}," button in the modal to confirm you want to use Person Accounts for Employees."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Happens When You Click Yes:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Employee object mapping is saved as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person Account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The dropdown display changes to show ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Person Account\""]}," (not \"Account\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When querying Employees, the application adds ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WHERE IsPersonAccount = true"]}," to filter only Person Account records"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Field mappings now expect Person Account field names (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonEmail"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonPhone"]},", etc.)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Click Save Button."]}," Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," button (checkmark icon) next to the Employee dropdown to persist your Person Account configuration."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update Field Mappings for Person Account Fields."]}," Navigate to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Mapping"]}," tab and update Employee field mappings to use Person Account field names:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Onboarded™ Field"},"children":["Onboarded™ Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Person Account Field (Use This)"},"children":["Person Account Field (Use This)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Contact Field (Don't Use)"},"children":["Contact Field (Don't Use)"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FirstName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"s","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact.FirstName"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LastName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"s","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact.LastName"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonEmail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"s","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact.Email"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Phone"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonMobilePhone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"s","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact.Phone"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account.Last_Onboarded_Sync__c"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["N/A"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field Name Differences:"]}," Person Account fields are on the Account object, not Contact. Key differences:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonEmail"]}," (not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonMobilePhone"]}," (not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePhone"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonMailingStreet"]}," (not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MailingStreet"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["All person-specific fields have \"Person\" prefix"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-account-query-behavior","__idx":3},"children":["Person Account Query Behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you configure Employee to use Person Accounts, the application adjusts its SOQL queries as follows:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Standard Contact Query (NOT Person Account Mode):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT FirstName, LastName, Email\nFROM Contact\nWHERE Onboarded_Id__c = '123'\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Person Account Query (Person Account Mode Enabled):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"sql","header":{"controls":{"copy":{}}},"source":"SELECT FirstName, LastName, PersonEmail\nFROM Account\nWHERE Onboarded_Id__c = '123' AND IsPersonAccount = true\n","lang":"sql"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Differences:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Query targets ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}," object (not Contact)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses Person Account field names (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonEmail"]}," not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount = true"]}," filter to exclude Business Accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Returns only Person Account records, not Business Accounts"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-account-scenarios","__idx":4},"children":["Person Account Scenarios"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"person-accounts-disabled-in-org","__idx":5},"children":["Person Accounts Disabled in Org"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Happens:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field does not exist on Account object"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Application detection method returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["\"Person Account\" option does NOT appear in Employee object dropdown"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Selecting \"Account\" for Employee maps to Business Accounts only"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No Person Account modal will appear"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recommended Action:"]}," Use Contact object for Employees instead of Account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"person-accounts-enabled-employees-on-contact","__idx":6},"children":["Person Accounts Enabled, Employees on Contact"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Happens:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Application detects Person Accounts are enabled (option available)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You choose to map Employee to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact"]}," object instead of Account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No Person Account modal appears (only triggers when Account is selected)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Employee data syncs to/from Contact records as normal"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use This When:"]}," Your org has Person Accounts enabled, but you want to keep employee data in Contact records separate from Account structure."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"account-mapping-with-no-selected","__idx":7},"children":["Account Mapping with \"No\" Selected"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Happens:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Application detects Person Accounts and shows modal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You click \"No\" in the Person Account modal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Employee object saved as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Account\""]}," (not \"Person Account\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Queries will include ALL Account records (Business + Person)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must manually filter Person Accounts if needed"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use This When:"]}," You want to use Business Accounts for Employees (uncommon scenario)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"account-mapping-with-yes-selected","__idx":8},"children":["Account Mapping with \"Yes\" Selected"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["What Happens:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Application detects Person Accounts and shows modal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You click \"Yes\" in the Person Account modal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Employee object saved as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Person Account\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Queries automatically filter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount = true"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only Person Account records are synced for Employees"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You must use Person Account field names in field mappings"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use This When:"]}," Your org uses Person Accounts to represent individual employees (most common Person Account scenario)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"person-account-troubleshooting","__idx":9},"children":["Person Account Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"person-account-option-missing-from-dropdown","__idx":10},"children":["\"Person Account\" Option Missing from Dropdown"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cause:"]}," Person Accounts are not enabled in your Salesforce org, or the application cannot detect the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPersonAccount"]}," field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solutions:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify Person Accounts are enabled: Setup → Account Settings → Enable Person Accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm you have a B2C or Person Account license"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refresh the Onboarded™ Setup tab after enabling Person Accounts"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check user permissions: Ensure Onboarded™ Admin permission set is assigned"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"business-accounts-for-employees","__idx":11},"children":["Business Accounts for Employees"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cause:"]}," Application detected Person Accounts but you want to use Business Accounts for Employee records (uncommon use case)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solutions:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click \"No\" in the Person Account modal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use standard Account field names (no \"Person\" prefix)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Be aware that queries will return ALL Account records unless filtered manually"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Better Alternative:"]}," Use Contact object for Employees instead of Account to avoid confusion."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"field-not-found-errors-after-enabling-person-account-mode","__idx":12},"children":["\"Field Not Found\" Errors After Enabling Person Account Mode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cause:"]}," Field mappings still reference Contact field names instead of Person Account field names."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solutions:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to Field Mapping tab"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update all Employee field mappings to use Person Account field names:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Email"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonEmail"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MobilePhone"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonMobilePhone"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MailingStreet"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PersonMailingStreet"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FirstName"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LastName"]}," (no Person prefix needed)"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save field mappings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test sync with \"Sync Now\" button"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pro Tip:"]}," After configuring Person Account mode, always test with a single record first. Use the \"Sync Now\" button on an Employee record page to validate field mappings before running scheduled sync jobs. This helps catch field name mismatches early."]}]}]},"headings":[{"value":"Person Accounts","id":"person-accounts","depth":1},{"value":"Person Account Detection","id":"person-account-detection","depth":2},{"value":"Person Account Mapping Setup","id":"person-account-mapping-setup","depth":2},{"value":"Person Account Query Behavior","id":"person-account-query-behavior","depth":2},{"value":"Person Account Scenarios","id":"person-account-scenarios","depth":2},{"value":"Person Accounts Disabled in Org","id":"person-accounts-disabled-in-org","depth":3},{"value":"Person Accounts Enabled, Employees on Contact","id":"person-accounts-enabled-employees-on-contact","depth":3},{"value":"Account Mapping with \"No\" Selected","id":"account-mapping-with-no-selected","depth":3},{"value":"Account Mapping with \"Yes\" Selected","id":"account-mapping-with-yes-selected","depth":3},{"value":"Person Account Troubleshooting","id":"person-account-troubleshooting","depth":2},{"value":"\"Person Account\" Option Missing from Dropdown","id":"person-account-option-missing-from-dropdown","depth":3},{"value":"Business Accounts for Employees","id":"business-accounts-for-employees","depth":3},{"value":"\"Field Not Found\" Errors After Enabling Person Account Mode","id":"field-not-found-errors-after-enabling-person-account-mode","depth":3}],"frontmatter":{"seo":{"title":"Person Accounts"}},"lastModified":"2026-08-27T18:30:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/onboarded_for_salesforce/person_accounts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}