Salesforce Docs Portal

Named Credentials

Intended to secure and simplify authenticated API callouts to external systems, a named credential specifies the URL of a callout endpoint and its required authentication parameters in one definition. To streamline your Apex code and simplify the setup of authenticated callouts, specify a named credential as the callout endpoint.

Required Editions

Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: all editions
Important
Important In Winter ’23, Salesforce introduced an improved named credential that’s extensible, customizable, and more secure. We strongly recommend that you use this preferred credential instead of legacy named credentials, which are no longer updated or enhanced. For information on extensible, customizable named credentials, see Named Credentials Schema.
  • Get Started with Named Credentials
    Understand the basics of named credentials, including the named credential schema and the authentication protocols that Salesforce supports.
  • Named Credential Example Configurations
    Explore scenarios for configuring named credentials to make callouts to various external systems. The examples cover the entire named credential configuration for different authentication protocols and principal types.
  • Create Named Credentials and External Credentials
    To simplify the setup of authenticated callouts, create an external credential to specify an authentication protocol and then specify a named credential as the callout endpoint. Add custom headers to cover more use cases and security requirements. Use a permission set or profile to grant access so that users can make authenticated callouts. You can create and configure named credentials programmatically or through the Salesforce UI.
  • Resources for Named Credentials
    Learn about considerations, troubleshooting tips, and more so that named credentials work the way you intend.

See Also