Advanced Analytica Advanced Analytica: IBOM
← All connectors
BambooHR logo

Source connector

BambooHR

Set up BambooHR as a source and move its data into your chosen destination.

Version 0.10.0 community alpha

BambooHR

Use this page to set up the BambooHR source connector and find reference information.

What you need

  • A BambooHR account with access to the data you want to sync.
  • A BambooHR API key. API requests use the permissions of the user who generated the key. Choose a user who can view the employees, time off and time tracking data you want to sync.
  • Your BambooHR company subdomain. If you access BambooHR at https://mycompany.bamboohr.com, your subdomain is mycompany.

Generate an API key

  1. Log in to BambooHR.
  2. Select your name in the lower-left corner of any page to open the user menu.
  3. Select API Keys. This option only appears if you have sufficient permissions.
  4. Create a new API key. Copy it and store it securely.

For more information, see the BambooHR API documentation.

Set up the connector

  1. In Airbyte, go to Sources and select New source.
  2. Select BambooHR from the list of sources.
  3. Enter a name for the source.
  4. For api_key, enter your BambooHR API key.
  5. For subdomain, enter your BambooHR company subdomain.
  6. Optional: For custom_reports_fields, enter a comma-separated list of BambooHR field names to request in the custom_reports_stream stream. For example, enter firstName,lastName,department. The connector only requests the fields you list. Enter every field you want in that stream.
  7. Optional: For employee_fields, enter a comma-separated list of BambooHR field names to request in the employees stream. The default is firstName,lastName.
  8. Optional: For Start date, enter the UTC date and time for starting the time_off_requests_stream and timesheet_entries stream syncs. Use the format YYYY-MM-DDTHH:MM:SSZ. If left blank, the connector syncs data from about 31 days before the current date.
  9. Select Set up source.

The configuration form includes custom_reports_include_default_fields, but the current connector version doesn’t use it. To include fields in the custom_reports_stream stream, list them in custom_reports_fields.

Supported sync modes

The BambooHR source connector supports these sync modes:

FeatureSupported?
Full Refresh SyncYes
Incremental - Append SyncYes
NamespacesNo

Supported streams

StreamBambooHR endpointPrimary keyIncrementalNotes
custom_reports_streamRequest a custom reportNoneNoOne record per employee, containing the fields listed in custom_reports_fields.
employees_directory_streamGet employee directoryidNoReturns only employees and fields that your company shares in its Company Directory settings.
employeesGet employeeNoneYesRequests each employee from employees_directory_stream with the fields listed in employee_fields. Every sync reads all employees.
meta_fields_streamGet a list of fieldsNoneNoLists the fields available in your BambooHR account. Use it to find field names for custom_reports_fields and employee_fields.
time_off_requests_streamGet time off requestsNoneYesCursor field: created. Each incremental sync re-reads the previous 365 days to capture updated requests.
timesheet_entriesGet timesheet entriesidYesCursor field: start.

Limitations and troubleshooting

Expand to see details about BambooHR connector limitations and troubleshooting.

Rate limits

BambooHR doesn’t publish fixed rate limits, but may throttle requests it considers too frequent. BambooHR then returns an HTTP 429 response with a Retry-After header. The connector retries the request. For more information, see the BambooHR technical overview.

Permission errors

An HTTP 403 error means the API key’s user can’t access that stream’s data. Use an API key from a user with the required access. The employees_directory_stream stream and its dependent employees stream also return 403 in one case. This happens when the Company Directory isn’t shared with the API key user’s access level.

Check the connection

The connector checks the connection by reading meta_fields_stream. If it returns an HTTP 404 error, verify your subdomain.

IP allow list

If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
0.10.02026-11-1091540Expand declared fields and improve timesheet and time-off incremental sync reliability.
0.9.42026-11-1091320Upgrade base image to source-declarative-manifest 7.47.0
0.9.32025-05-2460660Update dependencies
0.9.22025-05-1059340Update dependencies
0.9.12025-04-2658243Update dependencies
0.9.02025-04-1457587change how to collect custom fields for custom reports
0.8.32025-04-1257604Update dependencies
0.8.22025-04-0557190Update dependencies
0.8.12025-03-2956627Update dependencies
0.8.02025-03-2554688Add employees stream
0.7.32025-03-2256137Update dependencies
0.7.22025-03-0855362Update dependencies
0.7.12025-03-0154842Update dependencies
0.7.02025-02-2754701Add timesheet_entrees stream
0.6.22025-02-2254238Update dependencies
0.6.12025-02-1553873Update dependencies
0.6.02024-12-0248759Fix incremental for TimeOff Requests stream
0.5.92025-02-0853441Update dependencies
0.5.82025-02-0152909Update dependencies
0.5.72025-01-2552201Update dependencies
0.5.62025-01-1851771Update dependencies
0.5.52025-01-1151263Update dependencies
0.5.42024-12-2850440Update dependencies
0.5.32024-12-2150206Update dependencies
0.5.22024-12-1449543Update dependencies
0.5.12024-12-1249025Update dependencies
0.5.02024-10-2847262Migrate to Manifest-only
0.4.142024-10-2847072Update dependencies
0.4.132024-10-1246842Update dependencies
0.4.122024-10-0546500Update dependencies
0.4.112024-09-2846157Update dependencies
0.4.102024-09-2145766Update dependencies
0.4.92024-09-1445542Update dependencies
0.4.82024-09-0745210Update dependencies
0.4.72024-08-3144978Update dependencies
0.4.62024-08-2444652Update dependencies
0.4.52024-08-1744272Update dependencies
0.4.42024-08-1243851Update dependencies
0.4.32024-08-1043467Update dependencies
0.4.22024-08-0343154Update dependencies
0.4.12024-07-2742779Update dependencies
0.4.02024-07-1841443Add TimeOff Requests stream
0.3.82024-07-2042200Update dependencies
0.3.72024-07-1341780Update dependencies
0.3.62024-07-1041437Update dependencies
0.3.52024-07-0941088Update dependencies
0.3.42024-07-0640818Update dependencies
0.3.32024-06-2540288Update dependencies
0.3.22024-06-2240156Update dependencies
0.3.12024-06-0639201[autopull] Upgrade base image to v1.2.2
0.3.02024-05-2537452Migrate to Low Code
0.2.62024-04-1937124Updating to 0.80.0 CDK
0.2.52024-04-1837124Manage dependencies with Poetry.
0.2.42024-04-1537124Base image migration: remove Dockerfile and use the python-connector-base image
0.2.32024-04-1237124schema descriptions
0.2.22022-09-1617684Fix custom field validation retrieve
0.2.12022-09-1616826Add custom fields validation during check
0.2.02022-03-2411326Add support for Custom Reports endpoint
0.1.02021-08-275054Initial release with Employees API
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.