Three ways to integrate
Pick the depth that fits your needs — start light, grow when ready.
Outbound — skaills enriches BambooHR
Planned~1-2 weeks. BambooHR's API is straightforward; the first connector stands up fast.
Bidirectional — BambooHR drives, skaills assesses
Planned~4-6 weeks. BambooHR webhooks + custom-field mapping + SSO if applicable.
BambooHR Marketplace — skaills as a partner
Roadmap3-4 months including BambooHR partner certification and security review.
What this looks like in practice
Concrete flows triggered by events in BambooHR.
| Trigger in BambooHR | What skaills does | What flows back to BambooHR |
|---|---|---|
| Candidate applies to a position posted in BambooHR Hiring | skaills generates a personalized evaluation link (right profile + sector + level) and sends it | Score + competency profile + recommendation appear as a custom field on the candidate record in BambooHR Hiring |
| Employee finishes a review cycle in BambooHR Performance | skaills runs competency evaluation + AI-Readiness + Growth Plan | Plan summary, next milestones, and learning recommendations appear as custom fields on their BambooHR profile |
| BambooHR satisfaction survey closes (eNPS / pulse) | skaills correlates with its multi-dimensional climate survey and generates an action plan | Consolidated engagement report delivered to the HR sponsor, with prioritized recommendations |
| CHRO requests a 12-month transformation roadmap | skaills generates an Org Transformation Plan with aggregated BambooHR data (structure, headcount, attrition) | CHRO-grade roadmap with capability heatmap, transformation tracks, and 30/90/180/365 KPIs delivered as a skaills dashboard |
Technical architecture
The integration uses BambooHR's official REST API. Authentication via a dedicated API key generated in your BambooHR account (scope limited to the necessary endpoints). BambooHR webhooks (when in bidirectional mode) land at a dedicated skaills Cloud Function (`bamboohrWebhook`) with signature verification. skaills never stores the API key outside Google Secret Manager. All skaills-side logic is serverless — no infrastructure for your team to run.
Implementation timeline
1
Week 1
Define which flows are in scope (candidates, employees, reviews, surveys) and what data travels. Identify the HR sponsor, the customer-side BambooHR technical owner, and the skaills team.Kickoff and scope
Deliverable:Signed scope document
2
Week 2
Generate BambooHR API key, configure custom fields where skaills scores will appear, first E2E test with a synthetic candidate.Technical setup
Deliverable:E2E test passing with synthetic data
3
Week 3
Activate with a real recruiting team or a manager and their team. 5-10 real candidates/employees complete the flow. We monitor completion, latency, score quality, satisfaction.Controlled pilot
Deliverable:Pilot report with real metrics
4
Week 4
Roll out to the rest of the organization. Internal documentation for HR and IT. Handoff session. Ongoing support at the agreed cadence.Rollout and handoff
Deliverable:Integration in production + runbook delivered
For customers with custom flows (non-standard fields, multi-department or multi-country workflows), add 1-2 weeks. For BambooHR Marketplace listing, add ~3 additional months.
