# 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="/files/1ru7kLzSfSot524XhA5z" alt=""><figcaption></figcaption></figure>
4. Find "Scrybe Salesforce for Jira" and click the Install button<br>

   <figure><img src="/files/v6wrCp6U3eZHbMdFhJEc" 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="/files/Ule0N3JEa9ZpTbGTbqOt" 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>


---

# 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.upsmith.app/atlassian-cloud/scrybe-external-data-objects-and-query-for-jira/administrator-guide/common-errors-on-salesforce-oauth.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.