> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DocuSign OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for DocuSign in StackOne. One-time admin setup required before your users can link DocuSign accounts via Hub.

<Warning>You will need administrator access to your DocuSign account to create and manage apps in the Apps and Keys settings.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a DocuSign App</h2>

  <p>Register a new application in DocuSign Settings to obtain OAuth credentials.</p>

  <Steps>
    <Step title="Access Apps and Keys">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to the DocuSign admin console where apps are managed.</p>

        <ul>
          <li>Sign in to your DocuSign account: <a href="https://apps.docusign.com" target="_blank" rel="noopener noreferrer">Production</a> or <a href="https://apps-d.docusign.com" target="_blank" rel="noopener noreferrer">Sandbox</a></li>
          <li>Click on the <strong>Admin</strong> tab in the top navigation bar</li>
          <li>In the left sidebar under <strong>Integrations</strong>, click <strong>Apps and Keys</strong></li>
        </ul>
      </div>
    </Step>

    <Step title="Create a New App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Create a new integration to generate your credentials.</p>

        <ul>
          <li>Click the <strong>Add App and Integration Key</strong> button</li>
          <li>Enter an <strong>App Name</strong> (e.g., "StackOne Integration")</li>
          <li>Click <strong>Create App</strong> to generate the Integration Key</li>
          <li>Your <strong>Integration Key</strong> (Client ID) will be displayed at the top of the app settings page</li>
          <li>Copy and store it securely</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Configure OAuth Settings</h2>

  <p>Set up the redirect URI and generate a secret key for your application.</p>

  <Steps>
    <Step title="Add Redirect URI">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Configure the callback URL required for the OAuth authentication flow.</p>

        <ul>
          <li>In your app settings, scroll to the <strong>Additional settings</strong> section</li>
          <li>Under <strong>Redirect URIs</strong>, click <strong>Add URI</strong></li>
          <li>Enter exactly: `https://api.stackone.com/connect/oauth2/docusign/callback`</li>
          <li>Click <strong>Save</strong> to apply</li>
        </ul>
      </div>
    </Step>

    <Step title="Generate Secret Key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Create a secret key for your application.</p>

        <ul>
          <li>In the <strong>Authentication</strong> section of your app settings, locate <strong>Secret Keys</strong></li>
          <li>Click <strong>Add Secret Key</strong></li>
          <li>A new secret key will be generated and displayed</li>
          <li><strong>Important:</strong> Copy the secret key immediately - it is only shown once</li>
          <li>Store it securely in a password manager</li>
          <li>If lost, you will need to generate a new one</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Important Notes</h2>

  <p>Key information about DocuSign OAuth authentication and environments.</p>

  <ul>
    <li>DocuSign supports both <strong>Sandbox</strong> and <strong>Production</strong> environments</li>
    <li>For Sandbox testing, use the <a href="https://developers.docusign.com/" target="_blank" rel="noopener noreferrer">DocuSign Developer Account</a> and create apps at <a href="https://apps-d.docusign.com" target="_blank" rel="noopener noreferrer">apps-d.docusign.com</a></li>
    <li>For Production, your app must go through <a href="https://developers.docusign.com/docs/esign-rest-api/go-live/" target="_blank" rel="noopener noreferrer">DocuSign's Go-Live process</a> before it can be used</li>
    <li>Access tokens expire after 8 hours and are automatically refreshed</li>
    <li>The default scope "signature" provides access to all eSignature operations</li>
  </ul>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>DocuSign</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>DocuSign</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Integration Key</strong></li>
          <li><strong>Secret Key</strong></li>
          <li><strong>OAuth Scopes</strong> (Optional)</li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>DocuSign</strong>.