Skip to Content

2-legged OAuth 2.0 prerequisites for Jitterbit Connect Salesforce wizards in Design Studio

Introduction

These are the prerequisites for using 2-legged OAuth 2.0 with Jitterbit Connect Salesforce wizards. You need your Salesforce instance URL, a client ID, and a client secret for a successful connection using 2-legged OAuth 2.0 authentication.

Note

Design Studio version 11.59 and agent version 11.59 / 12.3 or later are required to use 2-legged OAuth 2.0 with the Jitterbit Connect Salesforce wizards.

Basic authentication no longer supported by Salesforce

Starting with Salesforce API version 65, Salesforce no longer supports SOAP API login (basic authentication). To ensure continued operability in Design Studio Salesforce Orgs configured to use basic authentication, do not accept the prompt to upgrade your existing Design Studio projects to Salesforce API version 65. Before upgrading projects to Salesforce API version 65, you must reconfigure your Salesforce endpoints with the new Select OAuth 2.0 Client Credentials configuration option or your operations will fail.

Instance URL

Your Salesforce instance URL depends on your organization's My Domain setting:

  • If My Domain is enabled (default), your instance URL is https://exampleDomain.my.salesforce.com.
  • If My Domain is disabled, your instance URL is https://exampleInstance.salesforce.com.

Connected app

Important

As of Spring 2026, Salesforce restricted the creation of connected apps. If you are not already using an existing connected app, use an external client app instead.

If you have a previously configured Salesforce connected app, navigate to the app and click Manage Consumer Details. Retain the Consumer Key and Consumer Secret values to enter for the client ID and client secret during Salesforce Org wizard configuration.

External client app

To create and configure a Salesforce external client app to obtain the required client credentials, follow these steps:

  1. Create an external client app.

  2. Configure the external client app's OAuth settings

    • Set the Callback URL to one of the following URLs (depending on your organization's region):

      Region URL
      APAC https://apps.apac-southeast.jitterbit.com/design-studio/api/v1/oauth/authcode
      EMEA https://apps.emea-west.jitterbit.com/design-studio/api/v1/oauth/authcode
      NA https://apps.na-east.jitterbit.com/design-studio/api/v1/oauth/authcode

    • Under OAuth Scopes, select Manage user data via APIs (api). Consider additional OAuth scopes your implementation may require. For example, Access the identity URL service (id, profile, email, address, phone).

  3. Navigate to the app's OAuth settings and click Manage Consumer Details. Retain the Consumer Key and Consumer Secret values to enter for the client ID and client secret during Salesforce Org wizard configuration.

Next steps

Use the instance URL, client ID, and client secret with the Salesforce Org wizard to use 2-legged OAuth 2.0 authentication.