{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Troubleshooting"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-issues","__idx":1},"children":["Common Issues"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sync-not-running","__idx":2},"children":["Sync Not Running"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," No records syncing via the feed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Possible Causes:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The object's sync toggle is disabled in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Onboarded™ Setup → Data Operation Settings"]}," and/or the object is not mapped in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Object Configuration"]},", for the objects you expect the feed to backstop (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#feed-vs-webhook-scoping"},"children":["Feed vs. Webhook Scoping"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The org's initial data load hasn't completed yet — on a fresh install, initial population is performed by the Onboarded™ ETL (expected until that finishes; see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#initial-data-load"},"children":["Initial Data Load"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The scheduled job has been stopped for an extended period (deactivated user, removed CRON job)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["OAuth authentication not configured or expired"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scheduled job not active"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Scheduling user lacks required permissions"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Onboarded™ Setup → Data Operation Settings"]},", verify the sync toggle is enabled for each object you expect the feed to cover, and confirm the object is mapped in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Object Configuration"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the org's initial data load has completed (fresh installs are populated by the Onboarded™ ETL). If the scheduled job has been stopped for a long time and sync does not resume on its own, contact Onboarded™ support"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify OAuth authentication is connected (check status in Integration Settings > Authenticate)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check Apex Jobs for failed/aborted ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OnboardedEventSyncQueueable"]}," executions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Onboarded_Error_Log__c"]}," for specific errors"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the scheduling user has Onboarded™ Admin permission set"]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," These symptoms apply to the scheduled feed. The real-time webhook is unaffected by any of the above — if webhook deliveries are also missing, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#authentication-errors"},"children":["Authentication Errors"]}," and confirm the Webhook External Client App authorization from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#api-authentication"},"children":["API Authentication"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-errors","__idx":3},"children":["Authentication Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," 401 Unauthorized errors in logs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify OAuth connection status shows \"Connected\" in Onboarded™ Setup"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Try disconnecting and reconnecting to Onboarded™"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure your Client ID is correct"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Contact Onboarded™ support if credentials are expired"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"records-not-linking","__idx":4},"children":["Records Not Linking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Lookup fields (Employee, Employer) are blank"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Onboarded™ Setup → Data Operation Settings → Link References"]},", click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run Links Now"]}," and select the affected object to relink its existing records on demand (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#run-links-now-on-demand-per-object-linkage"},"children":["Run Links Now"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify parent records exist (Employers before Employees)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that Onboarded™ ID values match between related records"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"permission-errors","__idx":5},"children":["Permission Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," \"Insufficient access\" or \"CRUD\" errors in logs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the integration user has Onboarded™ Admin permission set"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the scheduling user has access to all target objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify field-level security allows access to all mapped fields"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review sharing rules if records are not being found"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Remember:"]}," Operations run in USER_MODE and respect the running user's permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"governor-limit-errors","__idx":6},"children":["Governor Limit Errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," \"Too many SOQL queries\" or \"CPU time limit exceeded\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Resolution:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reduce batch size in Onboarded™ Setup (try 100 or 50)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check for conflicting triggers on synced objects"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review automation (Flows, Process Builder) that may run during sync"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Consider running sync during off-hours"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"view-document-button-missing-for-some-users","__idx":7},"children":["View Document Button Missing for Some Users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The View Document button respects the optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentViewCustomPermission"]}," design property on the Employee Onboarded and Workflow Onboarded components. If the property is populated, only users with BOTH the Onboarded™ HR Representative permission set AND the named Custom Permission see the button. Also confirm PDF Storage is enabled (per the PDF Storage section) and that the task has a stored PDF."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"employer-task-button-missing-for-some-users","__idx":8},"children":["Employer Task Button Missing for Some Users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Employer Task button respects the optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["employerTaskCustomPermission"]}," design property. If set, users need BOTH the Onboarded™ HR Representative permission set AND the named Custom Permission. If unset, the button appears for any HR Rep or Admin."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"unlock-task-modal-shows-no-form-sections","__idx":9},"children":["Unlock Task Modal Shows \"No Form Sections\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Unlock Task modal fetches form sections for the task at click time. If the task's form has not been parsed by Onboarded™ yet, the unlock options will not be available. Wait for the next sync to complete and try again, or escalate to Onboarded™ support if the issue persists."]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Common Issues","id":"common-issues","depth":2},{"value":"Sync Not Running","id":"sync-not-running","depth":3},{"value":"Authentication Errors","id":"authentication-errors","depth":3},{"value":"Records Not Linking","id":"records-not-linking","depth":3},{"value":"Permission Errors","id":"permission-errors","depth":3},{"value":"Governor Limit Errors","id":"governor-limit-errors","depth":3},{"value":"View Document Button Missing for Some Users","id":"view-document-button-missing-for-some-users","depth":3},{"value":"Employer Task Button Missing for Some Users","id":"employer-task-button-missing-for-some-users","depth":3},{"value":"Unlock Task Modal Shows \"No Form Sections\"","id":"unlock-task-modal-shows-no-form-sections","depth":3}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-08-27T18:30:57.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/onboarded_for_salesforce/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}