Skip to main content
Ensure you have Salesforce Admin privileges for the org running Sage People.

Create an External Client App in Salesforce

In your Sage People Salesforce org, create an External Client App for StackOne.

1

Open Salesforce Setup

Sign in at login.salesforce.com (use test.salesforce.com for sandbox), then click Setup ⚙️ in the top-right.

2

New External Client App

Navigate to Platform Tools > Apps > App Manager and click New External Client App.

  • External Client App Name: StackOne Sage People Integration
  • API Name: StackOne_Sage_People_Integration
  • Contact Email: your admin email
  • Leave Distribution State set to Local.
3

Enable OAuth Settings

Check Enable OAuth Settings and configure as follows.

  • Callback URL: copy it from your Connector Profile
  • Selected OAuth Scopes: Manage user data via APIs (api), Perform requests at any time (refresh_token, offline_access)
  • Keep Require Proof Key for Code Exchange (PKCE) extension for Supported Authorization Flows checked. StackOne sends PKCE, and Salesforce turns it on for every app created on or after 9 July 2026.
  • Keep Require Secret for Web Server Flow and Require Secret for Refresh Token Flow checked
4

Save and Retrieve Credentials

Click Create, then open the app in External Client App Manager.

  • Go to Settings > OAuth Settings and click Consumer Key and Secret to retrieve the Consumer Key (Client ID) and Consumer Secret (Client Secret). You may be asked to verify your identity.
  • It can take 10–20 minutes for the app to become active.

Assign Sage People Permission Sets

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

1

Open Permission Set assignment

Setup > Users > Users > [API User] > Permission Set Assignments.

  • Sage People Employees API
  • Sage People Pay Details API
  • Sage People Salaries API
  • Sage People Bonuses API
  • Sage People Absences API
  • Sage People Absence Balances API
  • Sage People Timesheets API

Select Environment

Choose Production or Sandbox to match your Salesforce org.

1

Choose Environment

Select the environment that matches your Salesforce org.

  • Production: select for your live Sage People org (login.salesforce.com)
  • Sandbox: select for test orgs (test.salesforce.com)

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.