# Fix the Salesforce OAuth Error

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2Fzyi8M5zCPnauUdvo4K0V%2FScreenshot%202025-11-05%20at%2011.19.19%E2%80%AFAM.png?alt=media&#x26;token=cf79fcf9-e703-45f1-89a3-2c7a6e738ce7" alt=""><figcaption></figcaption></figure>

This happens because Salesforce requires the **Stacksync a**pp to be installed and approved in your **Organization** before anyone can use OAuth.

## Install the Stacksync App in Your Salesforce Org

Before any user can create a Salesforce connection in Stacksync, the **Stacksync** App must be installed in your Salesforce org. This step only needs to be done **once**.

#### 1. Make sure the installer has the required permission

The user who performs the first OAuth authorization **must** have the Salesforce permission:

**“Approve Uninstalled Connected Apps”**

To enable it:

1. Go to **Setup**
2. Search for **Profiles**
3. Open the profile of the user who will install the app\
   (e.g., **System Administrator** or any user profile with this permission)
4. Enable **“Approve Uninstalled Connected Apps”**

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2FW6sdZVM9kwDkJY0uivyD%2Fimage.png?alt=media&#x26;token=7e644a2f-9b36-4304-afcc-40d5f4dcd751" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2FDQWr3qZcgHs8EorLu6b1%2Fimage%20(1).png?alt=media&#x26;token=30838a72-9396-4762-8e2a-f7f8c29a57e6" alt=""><figcaption></figcaption></figure>

This permission lets the user approve and install connected apps.

#### **2. Perform the first OAuth authorization**

After the permission is enabled:

1. The user with that permission logs into **Stacksync**
2. Starts the **Salesforce OAuth flow**
3. Salesforce will show a prompt to **approve and install** the **Stacksync** App
4. Once approved, if you want other users in your organization to be able to install this app, go to **Setup → Connected Apps OAuth Usage**, find **Stacksync**, and click **Install.** After that, selected users will be able to authorize successfully.

<figure><img src="https://2867423571-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfJjIdV9cuW6K8asJjTPJ%2Fuploads%2Fyde5ATw6hu5GQ2vQCWXj%2FScreenshot%202026-02-20%20at%201.47.14%E2%80%AFPM.png?alt=media&#x26;token=4b0df1a4-2910-4c28-9742-10fe975999c5" alt=""><figcaption></figcaption></figure>

## **Other Users Can Now Use OAuth**

Once the **Stacksync** app is installed, other Salesforce users  (for example, a dedicated “Stacksync Integration User” with limited permissions) should be able to complete the OAuth flow without any extra steps.&#x20;

If a user still encounters an OAuth error, go to **Setup → Connected Apps OAuth Usage**, find **Stacksync**, click **Install or** assign access. After that, the user will be able to authorize successfully.

***

## **Final Result**

* **One user with the proper permission installs the app once**
* **All other allowed users can now use OAuth to create Salesforce connections in Stacksync**