Documentation Index Fetch the complete documentation index at: https://docs.parable.work/llms.txt
Use this file to discover all available pages before exploring further.
What You'll Need Credential Description API Key Generated from BambooHR settings Subdomain Your BambooHR subdomain
Overview Connect to BambooHR for comprehensive HR and people data.
Employees Profiles, job information, contacts
Time Off Balances, requests, policies
Prerequisites Administrator access required. You need privileges in to complete this setup.If you don’t have admin access, contact your administrator to:
Create the API credentials on your behalf, OR
Grant you temporary admin access to complete the setup
Admin access level in BambooHRAPI key generation permission
Setup Guide
Access Account Settings
Log in to BambooHR
Click your name in the upper right → Account Settings
Navigate to API Keys section
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. Verify Your Setup BambooHR uses Basic Auth with API key as username and x as password: Test Authentication
Get Employee
curl -u "YOUR_API_KEY:x" \ "https://api.bamboohr.com/api/gateway.php/yourcompany/v1/employees/directory"
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 UnauthorizedInvalid API key Verify key is correct 403 ForbiddenInsufficient permissions Ensure admin access level 404 Not FoundWrong subdomain Check subdomain in URL
Additional Resources
BambooHR API Official API documentation
