In this article

Overview

Snaps in the Salesforce Snap Pack use the Salesforce OAuth2 account to access the Salesforce application. For the OAuth2 account to function without any issue, ensure to create and configure a Connected App corresponding to the account as explained in the steps below. These steps also contain the information required to create/define a new OAuth2 account for using this Snap Pack.

Create a Connected app in Salesforce Portal

  1. Log into the Salesforce portal.

  2. Click the Setup(blue star)icon on the top-right of the page and select Setup.

  3. Navigate to PLATFORM TOOLS>Apps>App Manager.

  4. Click New Connected App.

  5. Enter the following required basic information to help identify your app in the Salesforce dashboard.

  6. Select the Enable OAuth Settings checkbox under API (Enable OAuth Settings).

  7. Enter the required Redirect or Callback URL (to which the response should be sent) in the Callback URL box. Based on the region your server is located, provide the URL in the following format:
    https://<control-plane-name>.snaplogic.com/api/1/rest/admin/oauth2callback/<snap-pack-name>
    where the <control-plane-name> corresponds to the domain part of your SnapLogic URL—elastic (global control plane) or emea (EMEA control plane).
    For example,
    https://emea.snaplogic.com/api/1/rest/admin/oauth2callback/salesforce
    https://elastic.snaplogic.com/api/1/rest/admin/oauth2callback/salesforce
    After successful authentication, Salesforce redirects to this Callback URL.

  8. Select the required OAuth Scopes. Scope determines the level of access that you want to provide to your application. You must subscribe to refresh_token and offline_access scopes. 
    Note: If you face any issues in authorizing the Salesforce OAuth2 Account, make sure that you deselect the  Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows checkbox in your registered application in Salesforce and retry.

  9. Click Save and wait for a few minutes for the app to work.

  10. After configuring the Connected App, you will receive the Client ID and Client Secret.

  11. Open the App you created and note the Client ID and Client Secret.

note
  • It might take up to 10 minutes for the changes to take effect for the new or updated app — you cannot work on it immediately.

  • Deleting a parent org also deletes all connected apps with OAuth settings enabled.

  • When providing the Callback URL during your configuration, if you are working with Salesforce Snaps, then adding Callback URL for Salesforce should be sufficient. However, if you are working with REST Snaps besides Salesforce, then you must add a Callback URL for REST as well.

  • It might take up to 10 minutes for the changes to take effect for the new or updated app — you cannot work on it immediately.

  • Deleting a parent org also deletes all connected apps with OAuth settings enabled.

  • When providing the Callback URL during your configuration, if you are working with Salesforce Snaps, then adding Callback URL for Salesforce should be sufficient. However, if you are working with REST Snaps besides Salesforce, then you must add a Callback URL for REST as well.

Locate/Define Information Required to Create your Salesforce OAuth2 Account

Specify the values required to create a successful Salesforce OAuth2 account.

  1. Navigate to the Salesforce Snap of your choice and set up the Salesforce OAuth2 Account with the following details:

  2. Click Authorize
    You will be redirected to the login page of Salesforce. If you provide any new scopes, then click on Install App.

    1. Log into Salesforce and accept the permissions.
      The Access token and the Refresh Token will be generated.

    2. Select the Auto-refresh token checkbox and save the account.


Related Links

Configuring Salesforce Accounts

Salesforce OAuth2 Account