---
schema_version: "1"
id: 69c037e01793aa9976222625fe027adb38821a4bc4a4d275da66609567659ce9
title: ConnectApi.OAuthCredentialAuthUrlInput
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_o_auth_credential_auth_url.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_o_auth_credential_auth_url.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: df488e5ec34f494341f5a20f57921160a47b31aa568fe889b0e23fc8de4b8205
description: OAuth authentication flow.
---
# ConnectApi.OAuthCredentialAuthUrlInput

OAuth authentication flow.

<table class="featureTable sort_table" summary="">
          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d682886e27">Property</th>
              <th class="featureTableHeader vertical-align-top " id="d682886e29">Type</th>
              <th class="featureTableHeader vertical-align-top " id="d682886e31">Description</th>
              <th class="featureTableHeader vertical-align-top " id="d682886e33">Required or Optional</th>
              <th class="featureTableHeader vertical-align-top " id="d682886e35">Available Version</th>
            </tr>
          </thead>
          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property"><samp class="codeph apex_code">external​Credential</samp></td>
              <td class="entry" headers="d682886e29" data-title="Type">String</td>
              <td class="entry" headers="d682886e31" data-title="Description">Fully qualified developer name of the external credential.</td>
              <td class="entry" headers="d682886e33" data-title="Required or Optional">Required</td>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property">56.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property"><samp class="codeph apex_code">principalName</samp></td>
              <td class="entry" headers="d682886e29" data-title="Type">String</td>
              <td class="entry" headers="d682886e31" data-title="Description">Name of the external credential named principal.</td>
              <td class="entry" headers="d682886e33" data-title="Required or Optional">Required if <samp class="codeph nolang">principalType</samp> is <samp class="codeph apex_code">NamedPrincipal</samp>
              </td>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property">56.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property"><samp class="codeph apex_code">principalType</samp></td>
              <td class="entry" headers="d682886e29" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/connectAPI_enums.htm#CredentialPrincipalTypeEnum"><samp class="codeph apex_code">ConnectApi.​CredentialPrincipal​Type</samp></a></td>
              <td class="entry" headers="d682886e31" data-title="Description">Type of credential principal.
                Values are:<ul class="ul bulletList">
                  <li class="li"><samp class="codeph apex_code">AwsStsPrincipal</samp></li>
                  <li class="li"><samp class="codeph apex_code">NamedPrincipal</samp></li>
                  <li class="li"><samp class="codeph apex_code">PerUserPrincipal</samp></li>
                </ul>
              </td>
              <td class="entry" headers="d682886e33" data-title="Required or Optional">Required</td>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property">56.0</td>
            </tr>
            <tr>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property"><samp class="codeph apex_code">returnUrl</samp></td>
              <td class="entry" headers="d682886e29" data-title="Type">String</td>
              <td class="entry" headers="d682886e31" data-title="Description">Return URL to apply to the authentication URL.</td>
              <td class="entry" headers="d682886e33" data-title="Required or Optional">Optional</td>
              <td class="entry" headers="d682886e27 d682886e35" data-title="Property">56.0</td>
            </tr>
          </tbody>
        </table>