Newer Version Available

This content describes an older version of this product. View Latest

External Credential OAuth URL

Get the URL for the OAuth token flow for an external credential.
Resource
1/named-credentials/credential/auth-url/o-auth
Available version
56.0
HTTP methods
POST

POST methods typically create an item, but for this resource POST is used to retrieve information.

Request body for POST
Root XML tag
<oAuthCredentialAuthUrl>
JSON example
1{
2"externalCredential": "salesforceOAuthExternalCredential",
3"principalName": "defaultNamedPrincipal",
4"principalType": "NamedPrincipal",
5"returnUrl": "lightning/setup/SetupOneHome/home"
6}
Properties
Name Type Description Required or Optional Available Version
externalCredential String Fully qualified developer name of the external credential. Required 56.0
principalName String Name of the external credential named principal. Required if principalType is NamedPrincipal 56.0
principalType String Type of credential principal. Values are:
  • AwsStsPrincipal
  • NamedPrincipal
  • PerUserPrincipal
Required 56.0
returnUrl String Return URL to apply to the authentication URL. Optional 56.0
Response body for POST
OAuth Credential Auth URL