bamboohr-core-workflow-a

# BambooHR Core Workflow A — Employee Management & Reports ## Overview Primary BambooHR workflows: CRUD operations on employees, directory sync to external systems, custom reports, and table data (job history, compensation, emergency contacts). ## Prerequisites - Completed `bamboohr-install-auth` setup - `BambooHRClient` from `bamboohr-sdk-patterns` - API key with appropriate permissions (read or read+write) ## Instructions ### Step 1: Add a New Employee ```typescript // POST /employees/ — minimum: firstName + lastName const newEmpRes = await fetch(`${BASE}/employees/`, { method: 'POST', headers: { Authorization: AUTH, 'Content-Type': 'application/json' }, body: JSON.stringify({ firstName: 'Sarah', lastName: 'Chen', department: 'Engineering', jobTitle: 'Backend Engineer', workEmail: 'sarah.chen@acmecorp.com', hireDate: '2026-04-01', location: 'San Francisco', status: 'Active', }), }); // New employee ID is in the Location header const locationHeader = newEmpRes.headers.get('Location'); // e.g., "https://api.bamboohr.com/.../v1/employees/456" const newId = locationHeader?.split('/').pop(); console.log(`Created employee ID: ${newId}`); ``` ### Step 2: Update Employee Fields ```typescript // POST /employees/{id}/ — only send fields you want to change await fetch(`${BASE}/employees/${newId}/`, { method: 'POST', headers: { Authorization: AUTH, 'Content-Type': 'application/json' }, body: JSON.stringify({ jobTitle: 'Senior ...