Loading
Salesforce Enforces New Security Requirements in Summer 2026Read More
Manage Users and Data Access
Create a Named Credential for the Tooling API

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

Available in: all editions except Starter
User Permissions Needed
To create named credentials Customize Applications

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 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 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
Example

Named Credential Example with URL and Scope Highlighted

Named Credential example

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

 
Loading
Salesforce Help | Article