Resolving Salesforce Account is Disconnected Error

Summary

This article outlines the steps to resolve the “Salesforce account disconnected” error in DBSync. This issue prevents successful synchronization and occurs when the Salesforce connector loses authorization or session validity. The steps provided will help users re-establish the connection with the correct credentials and access level, ensuring smooth integration.

Problem

When attempting to run a sync between Salesforce and another system (for example, QuickBooks, databases) via DBSync, the sync fails with an error indicating the Salesforce connector is disconnected.

Common error indicators include:

  • “Salesforce account linked to your DBSync account is disconnected.”

  • Sync tasks are not executing or failing during runtime.

This typically occurs due to expired sessions, changed credentials, or permission-related issues.

Applies To

Product/Service: DBSync Cloud Workflow Versions: All versions supporting Salesforce integration Operating Systems: Platform-independent (Cloud-based) Databases / Connectors: Salesforce Applicable To: Salesforce connector settings within DBSync integration projects

Solution

Prerequisites:

  • Admin access to DBSync

  • Valid Salesforce user credentials with the appropriate access level

  • Knowledge of the integration project name within DBSync

Steps:

  1. Log in to your DBSync account at https://app.mydbsync.com and navigate to Cloud Workflow.

  2. Open the integration project where the Salesforce sync is failing by clicking on its project name (e.g., ProjectName).

  3. Once on the Tasks page, locate the active task and click Configure.

  4. On the flow page, locate the connector on the Query, Transform, or Write steps that uses Salesforce.

  5. On the left sidebar, click the 9Bot icon labeled "Apps," then search for the Salesforce connector name.

  6. Click the pencil icon next to the connector to edit it.

  7. Gather the username and password used in the currently connected Salesforce account. If using a different user account, ensure that it has the same level of access and object permissions as the previously connected one.

  8. Click the link: “Would you like to reconnect?”

  9. A Salesforce login pop-up will appear. Complete the login process with your credentials.

  10. After successful login, click Test Connection.

A confirmation pop-up will appear in 5–10 seconds with the message Connection successful.

Workaround (If Applicable)

If you cannot log in with the original Salesforce credentials:

  • Try using a different user account that has full admin-level access.

  • Create a new Salesforce-connected app with appropriate permissions, then use its credentials to reconnect.

Caution: Using an account with insufficient access may result in failed field mappings or record sync errors.

Root Cause

The Salesforce connector in DBSync becomes disconnected due to:

  • Expired sessions

  • Changed or reset Salesforce user credentials

  • Revoked permissions or OAuth tokens

  • Attempted login with a user having insufficient permissions

Additional Information

  • How to Create a Connected App in Salesforce for DBSync

  • Troubleshooting OAuth Connection Errors in DBSync

  • Mapping Best Practices for Salesforce to QBO Sync

Last updated