BambooHR (OAuth)

Integrate your application with the BambooHR API

🚀 Quickstart

Connect to BambooHR (OAuth) with Nango and see data flow in 2 minutes.

1. Create the integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> BambooHR (OAuth).

   BambooHR requires a subdomain for authentication. You’ll need to provide your BambooHR subdomain when creating connections.

2. Authorize BambooHR (OAuth)

   Go to Connections -> Add Test Connection -> Authorize, then enter your BambooHR subdomain and log in to BambooHR. Later, you’ll let your users do the same directly from your app.

3. Call the BambooHR API

   Let’s make your first request to the BambooHR API (fetch employees information). Replace the placeholders below with your secret key, integration ID, and connection ID:

   cURL

   curl -X POST "https://api.nango.dev/proxy/v1/reports/custom?format=JSON" \
     -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
     -H "Provider-Config-Key: <INTEGRATION-ID>" \
     -H "Connection-Id: <CONNECTION-ID>" \
     -H "Content-Type: application/json" \
     -d '{
         "title": "Current Employees",
         "fields": [
             "id",
             "employeeNumber",
             "firstName",
             "lastName",
             "dateOfBirth",
             "address1",
             "bestEmail"
         ]
       }'
   

   Node

   Install Nango’s backend SDK with npm i @nangohq/node. Then run:

   import { Nango } from '@nangohq/node';
   
   const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
   
   const res = await nango.post({
       endpoint: '/v1/reports/custom',
       params: {
           format: 'JSON'
       },
       providerConfigKey: '<INTEGRATION-ID>',
       connectionId: '<CONNECTION-ID>',
       data: {
           "title": "Current Employees",
           "fields": [
               "id",
               "employeeNumber",
               "firstName",
               "lastName",
               "dateOfBirth",
               "address1",
               "bestEmail"
           ]
       }
   });
   
   console.log(res.data);
   

   Or fetch credentials with the Node SDK or API.

   ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4. Implement Nango in your app

   Follow our Auth implementation guide to integrate Nango in your app.

   To obtain your own production credentials, follow the setup guide linked below.

📚 BambooHR (OAuth) Integration Guides

Nango maintained guides for common use cases.

• How to register your own BambooHR OAuth app
  Register an OAuth app with BambooHR and obtain credentials to connect it to Nango

• How do I link my BambooHR account? Learn how to authenticate with BambooHR and link your account

Official docs: BambooHR API docs

🧩 Pre-built syncs & actions for BambooHR (OAuth)

Enable them in your dashboard. Extend and customize to fit your needs.

No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

---