API Token

Setup
Reference

What You'll Need

Credential	What it is
API Key	Generated from BambooHR settings
Subdomain	Your BambooHR subdomain

Overview

Connect Parable to BambooHR for comprehensive HR and people data.

Employees

Profiles, job information, contacts

Time Off

Balances, requests, policies

Prerequisites

Setup access in . These steps require , or a colleague with equivalent permissions who can create credentials for you.If that is not you, ask your administrator.

Admin access level in BambooHR
API key generation permission

Setup Guide

Access Account Settings

Log in to BambooHR
Click your name in the lower left
Select API Keys

Generate API Key

Click Add New Key
Name: Parable Integration
Click Generate Key

Copy your now!This is the only time it will be displayed. Store it in a secure password manager before closing this page.

Note Your Subdomain

Your BambooHR URL format:

https://yourcompany.bamboohr.com

Your subdomain is yourcompany.

Enter values in the form

Subdomain and API Key: Enter your BambooHR subdomain and API key.
Click Save & test connection.

Verify Your Setup

BambooHR uses Basic Auth with API key as username and x as password:

curl -u "YOUR_API_KEY:x" \
  "https://api.bamboohr.com/api/gateway.php/yourcompany/v1/employees/directory"

curl -u "YOUR_API_KEY:x" \
  "https://api.bamboohr.com/api/gateway.php/yourcompany/v1/employees/0/?fields=firstName,lastName,jobTitle"

Success! If you received a 200 OK response with valid data, your credentials are configured correctly. You can now proceed to configure this connector in Parable.

Rate Limits: enforces rate limits of .Parable handles rate limiting automatically with exponential backoff, but initial syncs of large datasets may take longer due to these limits.

Troubleshooting

Error	Meaning	Solution
`401 Unauthorized`	Invalid API key	Verify key is correct
`403 Forbidden`	Insufficient permissions	Ensure admin access level
`404 Not Found`	Wrong subdomain	Check subdomain in URL

Additional Resources

BambooHR API

Official API documentation

Release Notes

Connectors

What You'll Need

Overview

Employees

Time Off

Prerequisites

Setup Guide

Verify Your Setup

Troubleshooting

Additional Resources

BambooHR API

What You'll Need

​Overview

Employees

Time Off

​Prerequisites

​Setup Guide

​Verify Your Setup

​Troubleshooting

​Additional Resources

BambooHR API

Overview

Prerequisites

Setup Guide

Verify Your Setup

Troubleshooting

Additional Resources