Skip to content

OAuth Error: Approve Uninstalled Connected Apps

Overview

When authorising MoveData via Settings → General → Authorise MoveData or during the Setup Wizard, you may encounter a Salesforce OAuth error page preventing authentication from completing.

There are two possiblities for the error:

  • the Salesforce user's profile does not have permission to approve access to connected apps that are not installed in the current organisation;
  • the Connected App must be installed and configured first

Missing Permissions Error

  • URL Pattern:
https://<mydomain>.my.salesforce.com/setup/secur/RemoteAccessErrorPage.apexp?error=invalid_client&error_description=app+must+be+installed+into+org
  • Error Message:
We can't authorize you because of an OAuth error. For more information, contact your Salesforce administrator.

OAUTH_APPROVAL_ERROR_GENERIC : An unexpected error has occured during authentication. Please try again.

Cause

The Salesforce user profile assigned to the user attempting to authorise MoveData does not have the Approve Uninstalled Connected Apps system permission enabled. This permission is required for MoveData to establish an OAuth connection with Salesforce.

Resolution

Step 1: Enable the Profile Permission

Tip

If you are unsure which profile the user has, navigate to Setup → Users, locate the user, and check their assigned profile.

  1. Navigate to Setup → Users → Profiles
  2. Open the profile assigned to the user who is authorising MoveData
  3. Click System Permissions
  4. Enable Approve Uninstalled Connected Apps
  5. Click Save

Step 2: Authorise MoveData

  1. Navigate to MoveData → Settings → General
  2. Click Authorise
  3. Log in as the desired user when prompted
  4. Grant the necessary permissions
  5. Verify the new user appears in the Authorised User field

Step 3: Restore the Profile Permission

Once MoveData has been successfully authorised, restore the profile permission to its original state:

  1. Navigate to Setup → Users → Profiles
  2. Open the same profile modified in Step 1
  3. Click System Permissions
  4. Disable Approve Uninstalled Connected Apps
  5. Click Save

Security Best Practice

Only enable this permission temporarily for the duration of the authorisation process. Disable it once authorisation is complete to maintain your organisation's security posture.

Connected App Error

Cause

The MoveData application has not been approved as a Connected App.

Resolution

Step 1: Install the Connected App

  1. Navigate to Setup → Apps → Connected Apps → Connected App OAuth Usage
  2. Find "MoveData" in the list
  3. Click Install button
  4. A new window will appear; Click Install to install the Connected App

Note

Depending on the number of attempts to authorise, Salesforce may have marked the Connected App as blocked. We recommend navigating back to the Connected App OAuth Usage page and ensuring that Unblock button is disabled; if not, please click the Unblock button.

Step 3: Grant permissions to the Connected App

  1. The connected app will appear
  2. This can also be viewed by navigating to Setup → Apps → Connected Apps → Manage Connected Apps
  3. Scroll down to Profiles and click Manage Profiles
  4. Select the Profile assigned to the user who is authorising MoveData
  5. Click Save

Step 2: Authorise MoveData

  1. Navigate to MoveData → Settings → General
  2. Click Authorise
  3. Log in as the desired user when prompted
  4. Grant the necessary permissions
  5. Verify the new user appears in the Authorised User field

Additional Resources