> ## Documentation Index
> Fetch the complete documentation index at: https://nango-marcin-nan-6306-mcp-tool-connections-get.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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-jwt/app_basic_info.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=573706fdd67bc8d3c0f8daa3a2a3cd75" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-jwt/enable_oauth.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=19c0934bb6f3c39985ddcc49e545e2a4" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-cc/enable_client_credentials.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=ce68c966758f9a4acb6721288d19c68a" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-jwt/app_policies.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=ad6604c7b6ea19162cb932a9c7c033f6" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-jwt/client_credentials.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=0f9d8b4a9383644010dc1f7bae772513" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-jwt/consumer_credentials.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=82abab57214a03e4ae82ae8a8bf0316e" 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-marcin-nan-6306-mcp-tool-connections-get/NvxUb4Fxc4Kvpbzs/api-integrations/salesforce/hostname.png?fit=max&auto=format&n=NvxUb4Fxc4Kvpbzs&q=85&s=0973b2dac41b57d8f8ebd903a3d10757" 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-marcin-nan-6306-mcp-tool-connections-get/iD44EfTq4Dm7Gst_/api-integrations/salesforce-cc/form.png?fit=max&auto=format&n=iD44EfTq4Dm7Gst_&q=85&s=c9127092bd4a3dd5c4088b810a8491da" style={{maxWidth: "450px" }} width="500" height="699" data-path="api-integrations/salesforce-cc/form.png" />

You are now connected to Salesforce using Client Credentials.