With recent Salesforce changes to connected apps, we are no longer allowed to create a connected app using the metadata api; in other words, the connected app can not be automatically created by Unbabel. This will require some one time extra manual steps to set up our integration.
In this document we are going to explain how to create a Salesforce External Client App (replaces connected apps on Spring 26).
The options to configure the Unbabel Connector with an External Client App require that you have version 3.106 of our package installed.
How to configure the Unbabel Connector package on a fresh installation
1 - Create a External Client App (legacy connected app)
- a) Go to Setup → External Client App manager
- b) Press the button New External Client App
-
c) Under Basic Information, Fill in mandatory fields
- d) Scroll down to expand API (Enable OAuth Settings), select Enable OAuth and fill in the following fields:
- Callback url: https://salesforce.unbabel.com/oauth/callback/
-
OAuth scopes: select the ones in the image below
- For Flow Enablement, select Enable Token Exchange Flow and Require secret for Token Exchange Flow
- In security, select Require secret for Web Server Flow
- e) Click create to complete.
2 - Open your newly created app and choose the Settings tab.
3 - Expand OAuth settings and click the button Consumer Key and Secret.
4 - A new page will open with these secrets. You will need them to configure the Unbabel Connector.
5 - On a new tab, open the Unbabel - Configuration Menu
6 - Fill in the required fields.
- Contact Email
- Unbabel username provided by Unbabel
- Unbabel API key provided by Unbabel
- Consumer key from the External app we’ve just created
- Consumer secret from the External app we’ve just created
7 - Click Create app and wait a few seconds; you will either see a popup or be redirected to a new page.
8 - Click Allow.
9 - Head back to the Unbabel - Configuration Menu.
10 - Click Test to verify that the the configuration succeeded.
The configuration is complete.
Upgrading from Version 3.105 or earlier to Version 3.106+
The steps required for this upgrade depend on your current Unbabel setup. Please review the scenarios below and follow the instructions that apply to your organization.
New Installations
Who this is for:
- Organizations using Unbabel for the first time
- Organizations that have recently refreshed their Salesforce org
What to do:
- Follow steps 1 through 10 in this guide.
Existing Installations
Who this is for:
- Organizations already using Unbabel successfully, no issues with authentication
What to do:
- No action is required, but you can consider migrating to an External Client App.
If your authentication is not working: Redo Authentication
Who this is for:
- Organizations already using Unbabel
- Authentication is failing after the upgrade, or you see this error when re-doing the authentication because you are running on Spring '26
What to do:
- Ensure you have Connector version 3.106 installed.
- In Salesforce, navigate to:
- Setup → App Manager
- Locate the connected app named UnbabelApp → View.
- Open the app and go to Manage Consumer Details.
- Repeat step 6 of this guide, using the Consumer Key and Consumer Secret from the UnbabelApp connected app.
If you want to migrate to an External Client App
Who this is for:
- Organizations currently using Unbabel
- Organizations that want to move from the Connected App authentication flow to an External Client App
What to do:
- Update to Connector package version 3.106
- In Salesforce, go to:
- Setup → App Manager
- Locate and open the connected app named UnbabelApp →View.
- Click to migrate the UnbabelApp
- Complete 6 to 10 of the guide