# Common Errors on Salesforce OAuth

#### Overview

When connecting to Salesforce, there are several common OAuth errors you might encounter. This guide walks through the typical causes and provides step by step actions to resolve each one.

{% hint style="info" %}
**NOTE:** It is recommended to connect with **System Administrator**
{% endhint %}

### **OAUTH\_APPROVAL\_ERROR\_GENERIC An unexpected error has occurred during authentication**

**Cause:**

Due to the following [change](https://help.salesforce.com/s/articleView?id=005132365\&language=en_US\&type=1), Salesforce Connected apps might need to be installed in an organization before OAuth authentication can be completed.

**Resolution Steps:**

When the initial user goes through the OAuth process, the app will be listed in the org and an admin will need to install the connected app.

1. Log in to Salesforce as a **System Administrator**.
2. Head to **Setup.**
3. Search for "Connected Apps OAuth Usage"<br>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FAcSXaVc8bCx6wl3QwZJJ%2Fo1.png?alt=media&#x26;token=160a9ae1-9f3b-46a4-a370-ef7663c59537" alt=""><figcaption></figcaption></figure>
4. Find "Scrybe Salesforce for Jira" and click the Install button<br>

   <figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FKibjOTmJUGUHSjUnIXFW%2Fo2.png?alt=media&#x26;token=b541ce47-2d5e-4305-92f8-6ca131fa7461" alt=""><figcaption></figcaption></figure>

Alternatively, you can also do the following:<br>

If the above option is not feasible, a Salesforce Administrator can grant a permission to the user's profile.

1. Login as Salesforce Administrator and navigate to **Setup**.
2. In the Quick Find box, search for "Profiles" and open the user’s profile.
3. In the "System Permissions" section, they should enable the "Approve Uninstalled Connected Apps" permission.<br>

   <div align="left"><figure><img src="https://639954725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlgzAhV4EMBU0KrkmJ6L0%2Fuploads%2FP4OxtGTsnqhgsgLPE4nn%2Fo3.png?alt=media&#x26;token=da152117-c27a-46ad-8b50-da92a157110e" alt=""><figcaption></figcaption></figure></div>

After the Salesforce Administrator completes the steps above, ask your users to do the following before attempting to connect again:\
• Clear their browser cache and cookies\
• Retry connecting to Salesforce again

### **OAUTH\_ERROR=TRUE**

Ensure that the user’s profile in Salesforce includes the "**API Enabled"** permission. This permission is essential for API access within your organization. Without it, the user will not be able to connect their personal Salesforce account to send activities.

### **OAUTH\_APP\_BLOCKED**

Verify that Scrybe Salesforce for Jira application is not blocked. If it is blocked, please unblock the app to restore access.

\
**Additional Resources**

If you need further assistance, don’t hesitate to contact our support team at **<support@upsmith.app>**. We’re always happy to help!<br>