> ## Documentation Index
> Fetch the complete documentation index at: https://nango-wari-integration-config-credentials-api.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce (Client Credentials) - How do I link my account?

## Overview

To authenticate with Salesforce (Client Credentials), you will need:

1. **Client ID** – The Consumer Key from your Salesforce External Client App.
2. **Client Secret** – The Consumer Secret from your Salesforce External Client App.
3. **Hostname** – Your Salesforce instance hostname (e.g. `acme.my.salesforce.com`).

This guide walks you through obtaining these values.

### Prerequisites

* A Salesforce account with administrative privileges to create External Client Apps.

### Instructions

#### Step 1: Create an External Client App

1. Log in to Salesforce and go to **Setup**.
2. In the Quick Find box, enter **App Manager**, then select **App Manager**.
3. Click **New External Client App**.
4. Fill in the required basic information (Name, API Name, Contact Email).

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-jwt/app_basic_info.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=317124827c929077855b939cbaf5c1bc" width="1910" height="734" data-path="api-integrations/salesforce-jwt/app_basic_info.png" />

5. Check **Enable OAuth Settings**.
6. For **Callback URL**, you can enter `https://api.nango.dev/oauth/callback`.
7. Under **Selected OAuth Scopes**, add at least `Access and manage your data (api)`.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-jwt/enable_oauth.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=e092a200df1bf7ee7c6d36dd50a39fe5" width="1910" height="812" data-path="api-integrations/salesforce-jwt/enable_oauth.png" />

8. Enable the Client Credentials flow:
   * In **OAuth Settings**: Under **Flow Enablement**, check **Enable Client Credentials Flow**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-cc/enable_client_credentials.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=de8e84106c4c1dc0987e2c5fe5fc3e84" width="1918" height="841" data-path="api-integrations/salesforce-cc/enable_client_credentials.png" />

9. Click **Save**.

#### Step 2: Assign an Execution User

For External Client Apps using the Client Credentials flow, Salesforce requires you to specify an execution user:

1. In **App Manager**, locate your app, click the dropdown arrow next to it, and select **Edit Policies**.
2. Navigate to the **OAuth Policies** section.
3. Under **OAuth Flows and External Client App Enhancements**:
   * Enable **Client Credentials Flow**.
   * In the **Run As (Username)** field, enter the username of a Salesforce user who has the necessary permissions required by the app.
4. Click **App Policies**, select the profiles or permission sets that can use this app, then click **Save**.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-jwt/app_policies.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=184adbe6ba2bc484205aa1410908d42a" width="1691" height="778" data-path="api-integrations/salesforce-jwt/app_policies.png" />

#### Step 3: Obtain Client ID and Client Secret

1. In the **App Manager**, find your app and go to the **Settings** tab.
2. Click **Consumer Key and Secret** to view your credentials.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-jwt/client_credentials.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=b3a26da42c2e452963c2ba9fce1c7293" width="1899" height="789" data-path="api-integrations/salesforce-jwt/client_credentials.png" />

3. Copy the **Consumer Key** (Client ID) and **Consumer Secret** (Client Secret).

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-jwt/consumer_credentials.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=3d590813724cd09b4d2a62d856076d0b" width="1899" height="373" data-path="api-integrations/salesforce-jwt/consumer_credentials.png" />

#### Step 4: Find your Hostname

1. Click on your profile to view your hostname.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce/hostname.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=0e195f26b5686f076200d236096d4a3b" width="500" height="250" data-path="api-integrations/salesforce/hostname.png" />

#### Step 5: Enter credentials in Nango

1. In the Nango Connect UI or dashboard, select the Salesforce (Client Credentials) integration.
2. Enter your **Hostname**, **Client ID**, and **Client Secret**.
3. Click **Authorize** to establish the connection.

<img src="https://mintcdn.com/nango-wari-integration-config-credentials-api/PJJtt2uGahQpP89v/api-integrations/salesforce-cc/form.png?fit=max&auto=format&n=PJJtt2uGahQpP89v&q=85&s=867e3172f96a837faec7e39d18692b19" style={{maxWidth: "450px" }} width="500" height="699" data-path="api-integrations/salesforce-cc/form.png" />

You are now connected to Salesforce using Client Credentials.