{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Using Your Own Objects","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"using-your-own-objects","__idx":0},"children":["Using Your Own Objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Onboarded™ application is designed to be flexible. You can map Onboarded™ data to your existing Salesforce objects instead of using the package's custom objects."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remember:"]}," The custom objects included with this package are purely optional convenience objects. Most organizations will benefit from mapping to their existing data model."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-mapping-scenarios","__idx":1},"children":["Common Mapping Scenarios"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"employees-to-contacts","__idx":2},"children":["Employees to Contacts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Map Onboarded™ employees directly to Salesforce Contact records:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the Employee object mapping to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add custom fields to Contact: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Onboarded_Id__c"]}," (Text, External ID), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Onboarded_Last_Sync__c"]}," (DateTime)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update field mappings to use Contact field API names (FirstName, LastName, Email, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure Account lookup if linking employees to employer Accounts"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"employers-to-accounts","__idx":3},"children":["Employers to Accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Map Onboarded™ employers to Salesforce Account records:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the Employer object mapping to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add custom fields to Account: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Onboarded_Employer_Id__c"]}," (Text, External ID), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Onboarded_Last_Sync__c"]}," (DateTime)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Update field mappings to use Account field API names (Name, BillingStreet, etc.)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consider using Record Types to differentiate Employer accounts from other account types"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"person-accounts","__idx":4},"children":["Person Accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For organizations using Person Accounts:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure the Employee object mapping to use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable the Person Account setting in the Onboarded™ Setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Map to Person Account fields (PersonEmail, PersonPhone, FirstName, LastName)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Note: Person Account field API names differ from Contact fields"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See the Person Accounts page for detailed setup instructions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"existing-custom-objects","__idx":5},"children":["Existing Custom Objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Map to your organization's existing custom objects:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identify which custom objects correspond to Onboarded™ entities"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add required fields: Onboarded™ ID (External ID) on all objects, and Last Sync timestamp on the Employee object"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Configure object mappings in Onboarded™ Setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create field mappings for each field you want to synchronize"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test with a small dataset before enabling full sync"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"required-fields-for-target-objects","__idx":6},"children":["Required Fields for Target Objects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure your target objects have the following fields:"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Properties"},"children":["Properties"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Onboarded™ ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Text (255)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External ID, Unique"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required on all objects. Matches records between systems."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Last Sync"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DateTime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required on Employee object only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This field is exclusively for whatever object you designate as the employee, and where the Employee Onboarded component will be set up. This field captures when the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sync Now"]}," operation within that component was last executed, preventing multiple users from clicking the button simultaneously (which could cause system errors)."]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Need to consolidate data from multiple objects?"]}," If your hiring or onboarding workflow spans multiple custom objects (e.g., Application, Interview, Offer, Background Check), see the Junction Object Patterns page for strategies on using Onboarded™ objects to centralize your integration."]}]}]},"headings":[{"value":"Using Your Own Objects","id":"using-your-own-objects","depth":1},{"value":"Common Mapping Scenarios","id":"common-mapping-scenarios","depth":2},{"value":"Employees to Contacts","id":"employees-to-contacts","depth":3},{"value":"Employers to Accounts","id":"employers-to-accounts","depth":3},{"value":"Person Accounts","id":"person-accounts","depth":3},{"value":"Existing Custom Objects","id":"existing-custom-objects","depth":3},{"value":"Required Fields for Target Objects","id":"required-fields-for-target-objects","depth":2}],"frontmatter":{"seo":{"title":"Using Your Own Objects"}},"lastModified":"2026-05-29T01:46:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/onboarded_for_salesforce/use_your_own_objects","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}