Dex
BambooHR logo
Directory & Identity

BambooHR

Keep BambooHR and IT in sync from Dex - directory lookups, onboarding and offboarding, IT assets, time off, files, and reports.

Dex connects to BambooHR through its REST API so you can run the HRIS side of IT conversationally. Look up the employee directory, detect joiners, movers, and leavers for identity and device provisioning, onboard new hires, offboard with a termination row, track IT assets, administer time off, manage employee and company files, and run saved reports. Employees get self-service through Dex Go for directory lookups, who is out, their own time off balance and requests, emergency contacts, and shared documents. Each Dex connection holds one per-company API key and runs with that key user's BambooHR access level, so a dedicated least-privilege integration user is the read boundary.

Start free →

What Dex does with BambooHR

Dex handles both admin workflows and employee self-service — all policy-guardrailed and audit-logged.

A

For admins (Dex Pro)

  • Look up the employee directory and roster by work email, status, department, or manager - named fields only
  • Detect joiners, movers, and leavers since a timestamp and hand the list to Entra ID, Okta, Google Workspace, Jamf, or Intune for provisioning
  • Onboard a new hire by creating the employee record and adding a job-info row
  • Offboard with an employment-status termination row - never a delete - then list assets to collect
  • Record IT assets issued to employees (laptop, phone, badge) and mark them returned
  • Administer time off - list, approve, deny, cancel, edit requests, and assign or unassign policies
  • Manage employee and company files - rename, re-categorize, change sharing, delete, or create folders
  • Run saved custom reports and read dataset metadata, with PII kept out of chat and tickets
E

For employees (self-service)

  • Find your manager or a coworker's title, department, or work phone from the directory
  • See who is out today and the next company holidays
  • Check your own time off balance by category
  • Request time off, which then enters your BambooHR approval chain
  • Check, edit, comment on, or cancel your own time off requests
  • Add or update your own emergency contact
  • See the names of documents shared with you

Just ask Dex

Your team types a request in plain language. Dex investigates, plans, and executes — with the right guardrails.

Admin prompts

  • >Who starts next week and still needs a laptop recorded in BambooHR?
  • >Offboard Sam on the 30th - add a Terminated employment-status row, then list the assets they still have out
  • >Show me who changed department this week so I can sync the moves to Entra ID
  • >Record a MacBook Pro 14 (serial C02XXXX) issued to ava.cohen@acme.com
  • >List all pending time off requests ordered by start date

Employee prompts

  • >Who is my manager?
  • >How much vacation do I have left?
  • >Book Friday the 6th off as PTO
  • >Did my time off request get approved?
  • >Update my emergency contact to my partner's mobile number

Policy actions

Every action Dex can take on BambooHR is declared, scoped, and guardrailed. Admins control which apply, who approves them, and whether they're limited to self-service.

ActionWhat it does
bamboohr_get_directoryRead the published BambooHR employee directory
bamboohr_list_employeesList or filter BambooHR employees (cursor-paginated roster)
bamboohr_get_employeeRead selected fields of one BambooHR employee
bamboohr_list_changed_employeesList employees inserted, updated, or deleted since a timestamp
bamboohr_get_employee_photoRead an employee's profile photo
bamboohr_create_employeeCreate a new employee record in BambooHR (onboarding)
bamboohr_update_employeeUpdate fields on a BambooHR employee record
bamboohr_delete_employeePermanently delete a BambooHR employee and all their data (disabled by default)
bamboohr_get_employee_tableRead an employee's table rows (job info, employment status, assets, and more)
bamboohr_list_changed_table_rowsList table rows changed since a timestamp across employees
bamboohr_add_job_infoAdd a job-info row (department, location, title, reports-to move)
bamboohr_update_job_infoCorrect an existing job-info row
bamboohr_add_employment_statusAdd an employment-status row (termination, leave, rehire, status change)
bamboohr_add_employee_assetRecord an IT asset (laptop, phone, badge) issued to an employee
bamboohr_update_employee_assetUpdate an employee asset row (serial, return date)
bamboohr_delete_employee_assetRemove an employee asset row
bamboohr_add_emergency_contactAdd an emergency contact for an employee
bamboohr_update_emergency_contactUpdate an employee emergency contact
bamboohr_add_table_rowAdd a row to any other employee table (compensation, pay, bank, dependents, and more) (disabled by default)
bamboohr_update_table_rowUpdate a row in any other employee table (compensation, pay, bank, and more) (disabled by default)
bamboohr_delete_table_rowDelete a row from any other employee table (compensation, job history, and more) (disabled by default)
bamboohr_list_time_off_requestsList time off requests (filter by employee, status, dates)
bamboohr_get_time_off_requestRead one time off request
bamboohr_create_time_off_requestRequest time off for the requester (enters BambooHR's own approval workflow)
bamboohr_update_time_off_requestEdit dates, amounts, or note of a time off request
bamboohr_approve_time_off_requestApprove a time off request (optionally bypassing remaining approvers)
bamboohr_deny_time_off_requestDeny a time off request
bamboohr_cancel_time_off_requestCancel a requested or not-yet-started approved time off request
bamboohr_list_time_off_request_commentsRead comments on a time off request
bamboohr_add_time_off_request_commentComment on the requester's own time off request
bamboohr_list_whos_outList approved time off overlapping a date range (who's out)
bamboohr_get_time_off_balanceRead an employee's time off balances as of a date
bamboohr_list_time_off_typesList time off types/categories
bamboohr_list_time_off_policiesList time off policies
bamboohr_list_employee_time_off_policiesList time off policies assigned to an employee
bamboohr_assign_time_off_policyAssign a time off policy to an employee
bamboohr_unassign_time_off_policyUnassign (end-date) an employee's time off policy
bamboohr_adjust_time_off_balanceManually adjust an employee's time off balance (payroll-impacting, disabled by default)
bamboohr_list_holidaysList company holidays
bamboohr_list_employee_filesList an employee's file categories and files
bamboohr_get_employee_fileDownload one employee file
bamboohr_update_employee_fileRename, re-categorize, or change sharing of an employee file
bamboohr_delete_employee_fileDelete an employee file
bamboohr_create_employee_file_categoryCreate an employee file category (folder)
bamboohr_list_company_filesList company file categories and files
bamboohr_get_company_fileDownload one company file
bamboohr_update_company_fileRename, re-categorize, or change sharing of a company file
bamboohr_delete_company_fileDelete a company file
bamboohr_create_company_file_categoryCreate a company file category (folder)
bamboohr_list_reportsList saved custom reports
bamboohr_run_reportRun a saved custom report (returns whatever the report selects)
bamboohr_list_datasetsList the reporting datasets
bamboohr_list_dataset_fieldsList the fields of a reporting dataset
bamboohr_get_dataset_field_optionsRead allowed filter values for dataset fields (read-only POST)
bamboohr_query_datasetBulk-export rows from a reporting dataset (PII export, disabled by default)
bamboohr_get_companyRead company properties (id, name, domain)
bamboohr_list_fieldsList employee fields and their aliases
bamboohr_list_tablesList employee tables and their fields
bamboohr_list_list_fieldsList list fields (departments, divisions, locations, and more) and their options
bamboohr_update_list_field_valuesAdd, rename, or archive options of a list field (e.g. a new department)
bamboohr_list_usersList BambooHR user accounts (who can sign in)
bamboohr_list_locationsList job locations
bamboohr_list_training_typesList training types
bamboohr_list_employee_trainingsList an employee's training records
bamboohr_add_employee_trainingRecord a completed training for an employee
bamboohr_update_employee_trainingUpdate an employee training record

How to configure BambooHR

Onboarding takes minutes. Dex validates your credentials before saving them.

Setup steps

  1. 1
    In BambooHR, create a dedicated integration user with a custom access level that covers the directory, job info, employment status, assets, emergency contacts, time off, and files Dex needs - and leaves out SSN, compensation, bank, tax, and dependents unless you need them.
  2. 2
    Signed in as that user, open the name menu (bottom-left) > API Keys > Add New Key and generate a key for Dex.
  3. 3
    Note your company label - the part before .bamboohr.com in your sign-in address (https://acme.bamboohr.com becomes acme).
  4. 4
    In Dex, enable the BambooHR integration and paste the company label and the API key.
  5. 5
    Dex validates the key with a live read of company metadata before saving, then discovery proposes policy with every write approval-gated and sensitive actions disabled by default.

Credentials required

company_domain
The company label before .bamboohr.com (https://acme.bamboohr.com becomes acme). Non-secret.
api_key
BambooHR API key generated under the integration user (name menu > API Keys). Secret.

Requirements

  • •A BambooHR account with API access enabled
  • •A dedicated least-privilege integration user whose access level is the read boundary - reads are not policy-gated in Dex, so field visibility is controlled by the key user
  • •Per-company connection: one Dex connection holds one API key for one BambooHR company (no shared global credential)
  • •File uploads are not supported through the API - upload in BambooHR directly

See Dex run BambooHR

Book a 30-minute walkthrough with our team and see how autonomous IT works in your environment — or get started for free.