Skip to main content
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.
1

Create a BambooHR Developer account

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

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

Configure OAuth settings

  1. In your application settings, click on App details and add https://api.nango.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 Nango will use to automatically refresh your access token, select Miscellaneous and grant the offline_access scope.
4

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 Nango.
5

Next

Follow the Quickstart to connect your first account.
For more details, see BambooHR’s OAuth documentation and how to create an application.