bamboohr-hello-world

# BambooHR Hello World ## Overview Minimal working examples for the three most common BambooHR API operations: fetch the employee directory, get a single employee by ID, and run a custom report. ## Prerequisites - Completed `bamboohr-install-auth` setup - `BAMBOOHR_API_KEY` and `BAMBOOHR_COMPANY_DOMAIN` env vars set ## Instructions ### Step 1: Fetch Employee Directory ```typescript import 'dotenv/config'; const COMPANY = process.env.BAMBOOHR_COMPANY_DOMAIN!; const API_KEY = process.env.BAMBOOHR_API_KEY!; const BASE = `https://api.bamboohr.com/api/gateway.php/${COMPANY}/v1`; const AUTH = `Basic ${Buffer.from(`${API_KEY}:x`).toString('base64')}`; // GET /employees/directory — returns all active employees const dirRes = await fetch(`${BASE}/employees/directory`, { headers: { Authorization: AUTH, Accept: 'application/json' }, }); const directory = await dirRes.json(); console.log(`Company has ${directory.employees.length} employees`); for (const emp of directory.employees.slice(0, 5)) { console.log(` ${emp.displayName} — ${emp.jobTitle} (${emp.department})`); } ``` **Directory response shape:** ```json { "fields": [ { "id": "displayName", "type": "text", "name": "Display Name" }, { "id": "jobTitle", "type": "text", "name": "Job Title" } ], "employees": [ { "id": "123", "displayName": "Jane Smith", "firstName": "Jane", "lastName": "Smith", "jobTitle": "Software Engineer", "department": "Engineering", "loc...