---
schema_version: "1"
id: e1875c70e1931d23e5fea73a12cc884162f1a969d8fb6ea21d971fc961364cea
title: Create a Named Credential for the Tooling API
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/perm_uapa_create_a_named_credential.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.perm_uapa_create_a_named_credential.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: cd1008b77b45a0723b5729fa7a58f43af989f6cc15e4cec3847cdb37b4f4f060
description: To work correctly, the credential that you create must have the API name Tooling_API_Credential.
products:
  - Security
  - Salesforce Platform
release: "264"
---
# Create a Named Credential for the Tooling API

To work correctly, the credential that you create must have the API name Tooling\_API\_Credential.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: all editions except <strong>Starter</strong></td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d66308e56">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d66308e56 ">To create named credentials</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d66308e56 ">Customize Applications</td>

          </tr>
        </tbody>
      </table>

To complete this task, you need the value of the callback URL in the authentication provider created in the [Create an Authentication Provider for the Tooling API](https://help.salesforce.com/s/articleView?id=platform.perm_uapa_create_auth_provider.htm&release=264.0.0&type=5 "Create an authentication provider to facilitate authentication with Salesforce.") task.

1. From Setup, in the Quick Find box, enter Named Credentials, and then select it.
2. Click the dropdown next to **New** and select **New Legacy**.
3. Enter the values:
    1. Label: Tooling API Credential
    2. Name: Auto-populates as Tooling\_API\_Credential
    3. URL: The domain from the callback URL that shows in the authentication provider. For example, if the callback URL is https://www.example.com/services/authcallback/PermhelperAuth, then the domain is https://www.example.com.
    4. Identity Type: Per User
    5. Authentication Protocol: OAuth 2.0
    6. Authentication Provider: The authentication provider created in the [Create an Authentication Provider for the Tooling API](https://help.salesforce.com/s/articleView?id=platform.perm_uapa_create_auth_provider.htm&release=264.0.0&type=5 "Create an authentication provider to facilitate authentication with Salesforce.") task.
    7. Scope: refresh\_token full
4. Select the Callout Options.
    1. Select the checkboxes for Generate Authorization Header and Allow Merge Fields in HTTP Body. Leave the other fields blank.
5. Save your changes.
    
    You’re prompted to log into your org.
6. Log in at the prompt.
7. At the connected app authorization screen, click **Allow**.
    
    When you’re redirected back to the Named Credential screen, the Administration Authentication Status field shows Authenticated as (your login).

![Example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-access-264-0-0-production-enus/a92be132-3cbc-412a-9262-130636120c14/images/icon_example.png)

Example

**Named Credential Example with URL and Scope Highlighted**

![Named Credential example](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-access-264-0-0-production-enus/a92be132-3cbc-412a-9262-130636120c14/access/images/uapa-named-credential.png)

(1) The URL with the domain value. (2) The scope.

Continue to [Create a Permission Set to Use the Named Credential](https://help.salesforce.com/s/articleView?id=platform.perm_uapa_create_a_permset.htm&release=264.0.0&type=5 "Create a custom permission set to enable users to use the Tooling API for the User Access and Permissions Assistant. You can assign this permission set to any users who use the app.").