Migrate from Teamtailor to BambooHR

Teamtailor Candidate records map to BambooHR Employee records. We extract name fields, email address, phone number, and address fields and map them to BambooHR's standard Employee fields. Candidate custom fields discovered during scoping are mapped to Employee Files categories rather than structured custom fields, since BambooHR stores extended candidate data as file attachments and category tags rather than typed fields. The BambooHR Employee record must exist before any linked Application record is created.

Teamtailor Job Applications map to BambooHR Application records when the customer's BambooHR plan includes the ATS module. Each Application is linked to the corresponding BambooHR Employee record created from the Candidate. Application status (active, rejected, hired) maps to BambooHR Application Status values, and the original application date is preserved. If the customer does not activate BambooHR ATS, applications are documented as Employee Files with an Application category attachment.

Teamtailor Job records map to BambooHR Job Requisitions via BambooHR's ATS module. We transfer job title, job status (open, paused, closed), department assignment, and job body content. Department is resolved against the BambooHR Department taxonomy created from Teamtailor Departments. Location maps to the BambooHR Location or Office object. Custom fields on job postings (discovered during scoping) are stored as Employee Files attachments against the Job Requisition or as custom fields if BambooHR ATS supports them for the customer's tier.

Teamtailor Departments export as a flat list and map directly to BambooHR Departments. The Teamtailor department ID is preserved in a BambooHR custom field for traceability. Department assignment on Jobs and Candidates migrates as a lookup reference to the corresponding BambooHR Department record.

Teamtailor Locations map to BambooHR Location records. Geographic metadata (city, country) is preserved in the Location record. If the customer uses Teamtailor's multi-location feature on jobs, each location becomes a separate BambooHR Location linked to the Job Requisition.

Teamtailor Users (hiring managers and recruiters) map to BambooHR Users by email address. Owner assignments on Candidates, Jobs, and Applications are preserved by resolving the Teamtailor user ID to the corresponding BambooHR User. Any Teamtailor User without a matching BambooHR User goes to a reconciliation queue for the customer's admin to provision before the migration resumes.

Teamtailor candidate custom fields are discovered by sampling records during scoping since Teamtailor exposes no metadata endpoint. Each discovered custom field is mapped to a corresponding Employee Files category in BambooHR. If Teamtailor's extended data migration setting is active (as recommended in the Teamtailor support article), custom field values transfer as structured data within the Employee Files category rather than plain text. The customer must create a default Resumes and applications category in BambooHR Employee Files before migration begins.

Teamtailor job posting custom fields are scoped to the job object and differ from candidate custom fields. We map these to BambooHR ATS custom fields if available on the customer's plan tier, or to a Job Notes field as structured text. The mapping strategy is confirmed during the scoping discovery pass when the actual field inventory is reviewed.

Candidate resumes, cover letters, and portfolio files referenced in Teamtailor are downloaded from the Teamtailor API URLs and uploaded as Employee Files in BambooHR. The file type (resume, cover letter, portfolio) is mapped to a BambooHR Employee Files category. If Teamtailor's extended data migration is enabled, file names and metadata are preserved. We download files in parallel batches to manage the Teamtailor 50 req/10s rate limit and queue retries with exponential backoff for throttled requests.

Teamtailor Interview Kits and structured interview questions are tied to jobs rather than candidates and are not exposed via a structured API endpoint for direct migration. We export kit names and associated question text as a written inventory document. BambooHR does not have a native Interview Kit feature, so the customer's admin rebuilds these using BambooHR's Workflow builder and document templates or a third-party interview scheduling tool like Calendly or Ashby.