Docebo Connect + BambooHR: SME integration setup guide
For a European SME running BambooHR as the HRIS and Docebo as the learning platform, the integration between them is a narrow, well-bounded piece of plumbing that pays for itself inside a quarter. Docebo Connect for BambooHR pulls employee records on a schedule and creates, updates, or deactivates Docebo user accounts to match. No spreadsheet reconciliation, no weekly ops batch, no drift.
This guide covers the off-the-shelf BambooHR connector in Docebo Connect — which is the right choice for almost every SME — along with the field mapping, API sanity checks, and the GDPR anchors that apply.
What the integration actually solves
Three operational problems a BambooHR → Docebo sync removes:
- New hires arrive in Docebo without a ticket. Within one recipe cycle of a BambooHR joiner being activated, their Docebo account exists with branch, manager, and learning-path assignments applied.
- Leavers are cut off deterministically. Deactivation in BambooHR flows to Docebo on the next sync — the window is minutes, not weeks.
- Department moves propagate. Docebo branches follow the BambooHR source, which means learning-path rules built on branches keep reflecting reality.
For a 30-person SME, the steady-state ops saving is modest — a couple of hours per month — but the compliance saving is larger. The audit trail is clean, the Record of Processing is enforceable, and there is no dormant-account backlog waiting to be discovered at the next ISO 27001 or ENS audit.
Off-the-shelf connector vs custom Docebo Connect recipes
Docebo Connect supports two paths for BambooHR integration:
- Off-the-shelf BambooHR connector (recommended). Docebo maintains a native connector with pre-built recipes for the standard employee-import workflow. Setup is guided, the field mapping is configurable, and the connector upgrades with Docebo itself. This is what we deploy 95% of the time.
- Custom recipes. Use Docebo Connect’s recipe builder to assemble a custom workflow, pulling from BambooHR’s REST API directly. Worth doing only when the SME has a non-standard requirement — bidirectional sync, two BambooHR tenants, or a custom field transform the off-the-shelf connector does not support.
For a ten-to-eighty person SME, the off-the-shelf connector is the correct default. If you find yourself sketching a custom recipe, be honest about whether the requirement is real or whether someone is preserving a legacy workflow that should be retired.
Prerequisites we confirm before building
Five items for week 1 of the integration work:
- Docebo Connect is activated on the SME’s Docebo instance.
- A BambooHR administrator account exists and can generate API keys. API access is a BambooHR entitlement — verify it is included in the SME’s subscription tier.
- Docebo Connect admin access is scoped to the integration engineer.
- A BambooHR test environment is available. BambooHR supports this via a sandbox request — allow a few business days to provision.
- Someone from HR has signed off the list of fields to sync and which is the source of truth for each.
The authoritative Docebo reference sits on help.docebo.com; general Docebo documentation is at docebo.com.
Field mapping for a BambooHR-Docebo sync
The field mapping we start from on a typical SME engagement:
| BambooHR field | BambooHR API path | Docebo field | Docebo API path | Transform |
|---|---|---|---|---|
| Work Email | workEmail | user.email | TRIM, LOWER | |
| First Name | firstName | firstname | user.firstname | TRIM |
| Last Name | lastName | lastname | user.lastname | TRIM |
| Employee ID | employeeNumber | userid | user.userid | PREFIX(BHR-) |
| Department | department | branch_id | user.branch_id | LOOKUP(dept_to_branch) |
| Job Title | jobTitle | additional_field_1 | user.additional_fields[0] | TRIM |
| Hire Date | hireDate | additional_field_2 | user.additional_fields[1] | DATE_FORMAT |
| Manager | supervisorEmail | manager_id | user.manager | LOOKUP(email_to_userid) |
| Status | employmentStatus | status | user.status | MAP(Active=0, Terminated=1) |
Two non-negotiables: department → branch is always a lookup table (not a free-text match), and manager is always resolved via email → Docebo userid. The PREFIX on employee ID keeps BambooHR-sourced users distinguishable in the Docebo user set from any records that pre-dated the integration.
Sample API calls for validating the sandbox
Before the scheduled recipe runs in production, we confirm the BambooHR API returns the expected shape:
# List employees changed since the last sync checkpoint
curl "https://api.bamboohr.com/api/gateway.php/COMPANY/v1/\
employees/changed?since=2026-03-27T00:00:00Z" \
-H "Accept: application/json" \
-u "API_KEY:x"
# Fetch a single employee record
curl "https://api.bamboohr.com/api/gateway.php/COMPANY/v1/\
employees/12345?fields=workEmail,firstName,lastName,department" \
-H "Accept: application/json" \
-u "API_KEY:x"
A 401 usually means the API key is wrong or BambooHR API access is not enabled on the tier. A 200 with unexpected field names usually means a custom field has been renamed in BambooHR since the spec was written — verify in sandbox before production.
GDPR anchors for a BambooHR → Docebo flow
The sync is a processing activity and has to appear in the SME’s Article 30 Record of Processing. Three items that have to be clean:
- Purpose. The data flows for training assignment and reporting. Any field beyond that scope — salary, medical notes, home contact — must not be mapped.
- Retention. Docebo user records for leavers follow the SME’s retention policy; we configure scheduled anonymisation to match.
- Legal basis. Employees under legitimate interest is the usual path; contractors and externals need review.
For SMEs operating under the Esquema Nacional de Seguridad, the recipe logs and user-change audit trail in Docebo Connect are directly useful as evidence for access-control and traceability controls.
Realistic timeline
The off-the-shelf BambooHR connector lands in 8–12 days of calendar time for a typical SME: prerequisites + field mapping + sandbox validation in week 1, production cutover + first reconciliation in week 2. For eligible Spanish SMEs, the Kit Digital scheme offers vouchers up to €12,000 for digitalisation projects, and this integration typically fits inside a broader Docebo deployment covered by the voucher.
Ready to get started?
Working on this yourself? J4SGON S.L. delivers Docebo Connect, HRIS, SSO and migration work for European organisations — see what a scoped engagement covers or describe your project and we will reply with a written scope.
Tell us what you are integrating or migrating
Send the platform, the systems involved and where you are stuck. You get a written scope back — phases, deliverables and what is out of scope — before anything is billed.