Skip to main content
A BambooHR Developer Portal account is required to register an OAuth application.

​
Register an OAuth Application

Register an application in the BambooHR Developer Portal to enable OAuth 2.0 authentication.

1

Sign into Developer Portal

Go to the BambooHR Developer Portal and create a free account if you don’t have one.

2

Create an Application

In the Developer Portal, create a new application:

  • Click Add Application
  • Provide your application name
  • Click Create Application
3

Configure Redirect URI

After being redirected to the app, click App details

  • Set the redirect URI as https://api.stackone.com/connect/oauth2/bamboohr/callback
  • Click Save Changes
4

Copy App Credentials

Copy the Client ID and Client Secret under App Credentials and store them securely for use later.

5

Select Application Scopes

Enables actions: Assign Time Off Policies, Clock In Employee, Clock Out Employee, Close Goal, Create Application Comment, Create Candidate, Create Company File Category, Create Employee, Create Employee Dependent, Create Employee File Category, Create Employee Training Record, Create Goal, Create Goal Comment, Create Hour Record, Create Job Opening, Create Or Update Clock Entries, Create Or Update Hour Entries, Create Or Update List Values, Create Project Task, Create Table Row, Create Time Off History Item, Create Time Off Request, Create Time Tracking Project, Create Training Category, Create Training Type, Create Webhook, Delete Clock Entries, Delete Company File, Delete Employee Training Record, Delete Goal, Delete Hour Entries, Delete Hour Record, Delete Table Row, Delete Training Type, Delete Webhook, Estimate Future Time Off Balances, Get Changed Employee IDs, Get Company File, Get Company Information, Get Dataset Data, Get Dataset Fields, Get Employee, Get Employee File Categories, Get Employee Photo, Get Employee Table Rows, Get Employee Time Off Policies, Get Field Options, Get Hour Record, Get Job Application Details, Get Report, Get States By Country, Get Webhook, Get Webhook Logs, List Applicant Statuses, List Benefit Coverages, List Benefit Deduction Types, List Break Policies, List Break Policy Breaks, List Company Files, List Company Holidays, List Company Locations, List Countries, List Datasets, List Employee Dependents, List Employee Files, List Employee Trainings, List Employees, List Employees Directory, List Fields, List Goal Alignment Options, List Goals, List Hiring Leads, List Job Applications, List Job Summaries, List List Fields, List Member Benefit Events, List Monitor Fields, List Project Tasks, List Reports, List Shift Differentials, List Tabular Fields, List Time Off Policies, List Time Off Requests, List Time Off Types, List Time Tracking Projects, List Timesheet Entries, List Training Categories, List Training Types, List Users, List Webhooks, List Who’s Out, Reopen Goal, Request Custom Report, Update Applicant Status, Update Company File, Update Employee, Update Employee Dependent, Update Employee Training Record, Update Goal, Update Hour Record, Update Table Row, Update Time Off Balance, Update Time Off Request Status, Update Webhook, Upload Company File

Under Application Scopes, select the scopes for your use case. You must also enable openid (required for authentication) and offline_access (required to issue refresh tokens) — if either is missing on the app, the connection fails with an invalid_scope / “An unsupported scope was requested” error:

6

Auth Config Scopes

When providing scopes in the Auth Config, list only the resource scopes for your use case, space-separated. openid and offline_access are required and are added automatically — you do not need to include them.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for BambooHR:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select BambooHR
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • OAuth Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for BambooHR.