BambooHR (Basic Auth)

🚀 Quickstart
🔗 Useful links
🚨 API gotchas

Create an integration

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

Authorize BambooHR

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

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
Node

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"
      ]
    }'

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 dynamically via the Node SDK or API.

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

Next step: Embed the auth flow in your app to let your users connect their BambooHR accounts.

Topic	Links
Authorization	Guide to connect to BambooHR (Basic Auth) using Connect UI
General	BambooHR Website
	BambooHR Dashboard
Developer	API Authentication
	API Reference

Contribute useful links by editing this page

Questions? Join us in the Slack community.

API Guides

APIs & Integrations

BambooHR (Basic Auth)