Hand off new hires from an ATS to BambooHR onboarding

Steps

1. Generate a BambooHR API key from the user menu in the BambooHR UI (click your name > API Keys); the BambooHR base URL is https://api.bamboohr.com/api/gateway.php/{companyDomain}/v1 where companyDomain is your BambooHR account subdomain
2. Authenticate using HTTP Basic Auth with your API key as the username and any string (e.g., 'x') as the password; include the Accept: application/json header to receive JSON responses
3. When a candidate is marked as hired in the ATS (via webhook or polling), extract the required new hire fields: first name, last name, hire date, job title, department, and email
4. Create the new employee record in BambooHR by sending POST /employees with a JSON body containing the mapped fields; the response returns the new employee ID
5. Update additional employee fields (manager, location, employment status, salary) via PUT /employees/{id} or POST /employees/{id}/tables/{tableName} for tabular data like compensation
6. Optionally trigger BambooHR's built-in onboarding workflows by setting the employee's hire date and ensuring the onboarding packet is configured in BambooHR settings — BambooHR sends the onboarding email to the new hire automatically based on the hire date