> ## 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.

# Sage People OAuth 2.0 (Authorization Code) connector profile – StackOne setup guide

> Set up the OAuth 2.0 (Authorization Code) connector profile for Sage People in StackOne. One-time admin setup required before your users can link Sage People accounts via Hub.

<Warning>Ensure you have Salesforce Admin privileges for the org running Sage People.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a Connected App in Salesforce</h2>

  <p>In your Sage People Salesforce org, create a Connected App for StackOne.</p>

  <Steps>
    <Step title="Open Salesforce Setup">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in at <a href="https://login.salesforce.com" target="_blank" rel="noopener noreferrer">login.salesforce.com</a> (use test.salesforce.com for sandbox), then click <strong>Setup</strong> ⚙️ in the top-right.</p>
      </div>
    </Step>

    <Step title="New Connected App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to <strong>Platform Tools</strong> > <strong>Apps</strong> > <strong>App Manager</strong> and click <strong>New Connected App</strong> (the older "Connected Apps" UI; not "External Client Apps").</p>

        <ul>
          <li><strong>Connected App Name:</strong> StackOne Sage People Integration</li>
          <li><strong>API Name:</strong> StackOne\_Sage\_People\_Integration</li>
          <li><strong>Contact Email:</strong> your admin email</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable OAuth Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Check <strong>Enable OAuth Settings</strong> and configure as follows.</p>

        <ul>
          <li><strong>Callback URL:</strong> `https://api.stackone.com/connect/oauth2/sagepeople/callback`</li>
          <li><strong>Selected OAuth Scopes:</strong> `Manage user data via APIs (api)`, `Perform requests at any time (refresh_token, offline_access)`</li>
          <li>Uncheck <strong>Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows</strong> (Salesforce returns `missing required code challenge` otherwise)</li>
          <li>Keep <strong>Require Secret for Web Server Flow</strong> and <strong>Require Secret for Refresh Token Flow</strong> checked</li>
        </ul>
      </div>
    </Step>

    <Step title="Save and Retrieve Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Save</strong>, then return to the Connected App detail page.</p>

        <ul>
          <li>Open <strong>Manage Consumer Details</strong> to retrieve <strong>Consumer Key</strong> (Client ID) and <strong>Consumer Secret</strong> (Client Secret).</li>
          <li>It can take 10–20 minutes for the app to become active.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Assign Sage People Permission Sets</h2>

  <p>Each Sage People REST endpoint enforces its own Salesforce Permission Set. Assign <strong>all seven</strong> to the user that will authenticate.</p>

  <Steps>
    <Step title="Open Permission Set assignment">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Setup > Users > Users > \[API User] > Permission Set Assignments.</p>

        <ul>
          <li>Sage People Employees API</li>
          <li>Sage People Pay Details API</li>
          <li>Sage People Salaries API</li>
          <li>Sage People Bonuses API</li>
          <li>Sage People Absences API</li>
          <li>Sage People Absence Balances API</li>
          <li>Sage People Timesheets API</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Select Environment</h2>

  <p>Choose Production or Sandbox to match your Salesforce org.</p>

  <Steps>
    <Step title="Choose Environment">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Select the environment that matches your Salesforce org.</p>

        <ul>
          <li><strong>Production:</strong> select for your live Sage People org (login.salesforce.com)</li>
          <li><strong>Sandbox:</strong> select for test orgs (test.salesforce.com)</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Sage People</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>Sage People</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0 (Authorization Code)</strong></li>

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

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID (Consumer Key)</strong></li>
          <li><strong>Client Secret (Consumer Secret)</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>Sage People</strong>.