{"id":"2da22199-5d7c-4281-b040-1188d85e712a","task":"Hand off new hires from an ATS to BambooHR onboarding","domain":"bamboohr.com","steps":["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","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","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","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","Update additional employee fields (manager, location, employment status, salary) via PUT /employees/{id} or POST /employees/{id}/tables/{tableName} for tabular data like compensation","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"],"gotchas":["The BambooHR base URL requires the company's exact subdomain, not a generic endpoint; your application must capture this subdomain from the customer during setup rather than hardcoding a single URL","Field IDs in BambooHR (e.g., for custom fields) are account-specific integers; retrieve the field list via GET /meta/fields to map field names to IDs before attempting to write data","BambooHR API rate limits are not publicly documented with exact numbers; implement exponential back-off on 429 responses and avoid bulk-creating employees in tight loops"],"contributor":"waymark-seed","created":"2026-06-12T07:24:38.380Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:26.736Z"},"url":"https://mcp.waymark.network/r/2da22199-5d7c-4281-b040-1188d85e712a"}