# 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

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FKPozkW2JXyTtDIxnU45L%2Funknown.png?alt=media&#x26;token=d44c356f-782f-4dd0-a516-26cd88cb758a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2F7tfNuOpbwQPw8vmEEuzW%2Funknown.png?alt=media&#x26;token=f331a051-2f01-480e-a1c4-f40ed76ae074" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FpyKIRKibsIglkjYDYEXF%2Funknown.png?alt=media&#x26;token=df530ec1-7443-4697-b777-d3012f647b35" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FkL3UxV0RL17bBYMGwWcj%2Funknown.png?alt=media&#x26;token=81c336c5-a17c-4184-b6fc-ada1340ed97c" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FTRY5So7vDfMRQsZpyYzg%2Funknown.png?alt=media&#x26;token=4fdc2921-68a5-407b-a803-5e75ac0c41b4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FDsWecIXre20pb6Gm5nE8%2Funknown.png?alt=media&#x26;token=26206b4f-e0d8-43e0-9003-1dfccf8ea152" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FjQ58Ykbj78L0gHcnStnJ%2Funknown.png?alt=media&#x26;token=98d5be6e-e985-42f3-9e3b-beae7c54d3bd" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mydbsync.com/cloud-workflow/troubleshooting/page-2/resolving-salesforce-account-is-disconnected-error.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
