How to register your own BambooHR OAuth app

Register an OAuth app with BambooHR and connect it to Tenklo

This guide shows you how to register your own OAuth application with BambooHR to obtain your OAuth credentials (client ID and secret) and scopes. These are required to let your users grant your app access to their BambooHR account.

Create a BambooHR Developer account

If you don't already have one, go to BambooHR Developers and create a developer account.

Create a new OAuth application

  1. Navigate to the Applications page and click the + Add application button.
  2. Fill in all the required details.
  3. Submit the form to proceed.

Configure OAuth settings

  1. In your application settings, click on App details and add https://api.tenklo.dev/oauth/callback as the Redirect URI.
  2. Configure the Scopes your application needs by clicking Select scopes and selecting the appropriate permissions.
    To obtain a refresh token that Tenklo will use to automatically refresh your access token, select Miscellaneous and grant the offline_access scope.

Get your credentials

After creating the application, you'll see your Client ID, Client Secret, and the list of Scopes Assigned. Copy these values as you'll need them when configuring the integration in Tenklo.

For more details, see BambooHR's OAuth documentation and how to create an application.