--- title: Teamtailor API Integration on Truto slug: teamtailor category: ATS canonical: "https://truto.one/integrations/detail/teamtailor/" --- # Teamtailor API Integration on Truto **Category:** ATS **Status:** Generally available ## Unified APIs ### Unified ATS API - **Applications** — The applications represent an application for a job. - **Attachments** — The attachments represent an attachment for a candidate. - **Candidates** — The candidates represent a candidate. - **Job Interview Stages** — The job interview stages represent a job interview stage. - **Jobs** — The jobs represent a job. - **Users** — The users represent a user. ## MCP-ready AI tools Truto exposes 12 tools for Teamtailor that AI agents can call directly. - **create_a_teamtailor_job** — Create a new job in Teamtailor. Requires user, title, and body. Returns fields including id, title, status, human-status, pitch, created-at, updated-at, and key relationship links for job resources. - **update_a_teamtailor_job_by_id** — Update a job in Teamtailor using id. Returns fields including title, status, tags, updated-at, and links to related resources such as division, role, and location. - **create_a_teamtailor_candidate** — Create a candidate in Teamtailor. Requires email unless sourced is true. Use merge to combine attributes with existing candidates. Returns candidate details including id, first-name, last-name, email, and pitch. - **update_a_teamtailor_candidate_by_id** — Update candidate in Teamtailor. Requires id. Returns updated candidate data including key fields such as id, type, and attributes reflecting modified details. - **create_a_teamtailor_upload** — Create an upload for a specific candidate in Teamtailor. Requires a public url and candidate id. Returns id, url, file-name, internal, and related candidate, job, and answer links in the response. - **create_a_teamtailor_job_application** — Create a new job application in Teamtailor. Requires candidate and job relationships in the request body. Returns id, created-at, sourced, updated-at, and relationship links for candidate, job, stage, and reject-reason. - **update_a_teamtailor_job_application_by_id** — Update a specific job application in Teamtailor by id. Returns cover-letter, created-at, updated-at, sourced, and relationship links for candidate, job, stage, and reject-reason. - **create_a_teamtailor_note** — Create a new note in Teamtailor for a candidate using their id and user id. Returns fields such as id, note, created-at, updated-at, candidate-id, and user-id in the response. - **update_a_teamtailor_note_by_id** — Update a specific note in Teamtailor using id. Returns the updated note attributes including note text, created-at, updated-at, candidate-id, and user-id. - **delete_a_teamtailor_note_by_id** — Delete a specific note in Teamtailor using id. Permanently removes the note and returns no content in the response. - **get_single_teamtailor_note_by_id** — Get a specific note in Teamtailor using id. Returns id, note text, created-at, updated-at, private-note, candidate-id, and user-id fields for detailed note information. - **create_a_teamtailor_transient_upload** — Create a transient upload in Teamtailor. Upload a file and return its transient URI, which can be used to attach the file to another resource. The URI is exposed once and must be stored immediately for reuse. ## How it works 1. **Link your customer's Teamtailor account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Teamtailor.** The Proxy API is a 1-to-1 mapping of the Teamtailor API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Push sourced candidates directly into Teamtailor pipelines** — AI sourcing and outbound recruiting platforms can export passive candidates — complete with resumes and job associations — into their customers' Teamtailor accounts without duplicating existing records, using the merge and sourced flags on candidate creation. - **Post assessment results and reports back into the ATS** — Candidate assessment and screening SaaS products can write test scores, interview summaries, and detailed PDF reports directly to a candidate's Teamtailor profile using notes and file uploads, so recruiters never leave their ATS to review results. - **Automate employee provisioning when a candidate is hired** — HRIS and onboarding platforms can monitor job application status changes via Truto's Unified ATS API and automatically pull candidate details to create employee profiles the moment an offer is accepted, eliminating manual data entry. - **Trigger background checks and e-signing from pipeline stage changes** — Compliance and background check SaaS products can listen for candidates reaching specific interview stages in Teamtailor and kick off verification workflows, then write the status back as a note on the candidate record. - **Sync job listings from Teamtailor into external platforms** — Job distribution and programmatic advertising tools can read active jobs from Teamtailor through Truto's Unified Jobs endpoint and keep external boards or campaign targets in sync, while pushing new applications back into the ATS. ## What you can build - **One-click candidate export with resume attachment** — Let recruiters push a sourced candidate, their parsed resume (via transient upload), and a job application into Teamtailor in a single action from your product. - **Automated assessment result cards on candidate profiles** — Post structured notes with scores and attach detailed PDF reports directly to a candidate's Teamtailor feed when they complete an assessment in your platform. - **Hired-candidate sync for onboarding automation** — Detect when a Teamtailor job application moves to a hired stage and pull candidate and job data into your HRIS or onboarding workflow automatically. - **Bi-directional job application pipeline management** — Create and update job applications programmatically — move candidates through interview stages or apply rejection reasons — without recruiters switching between tools. - **Contextual recruiter notes from external workflows** — Append, update, or delete notes on candidate profiles from your app, giving recruiters a unified activity feed that includes background check statuses, AI summaries, or referral context. - **Job creation and update sync from workforce planning tools** — Automatically create or update job postings in Teamtailor when headcount is approved in your workforce planning or requisition management product. ## FAQs ### What authentication method does the Teamtailor integration use? Teamtailor uses API key-based authentication. Your end users generate an API token from their Teamtailor admin settings and provide it through Truto's managed auth flow — Truto stores and manages the credential securely on your behalf. ### How does file upload work with the Teamtailor API through Truto? Teamtailor supports two upload methods: create_a_teamtailor_transient_upload lets you upload a file binary and receive a one-time URI that you then associate with a candidate or application, while create_a_teamtailor_upload attaches a document via a publicly accessible URL directly to a candidate profile. ### Can I avoid creating duplicate candidates when pushing data into Teamtailor? Yes. When calling create_a_teamtailor_candidate, you can set the merge attribute to true. If a candidate with the same email already exists, Teamtailor will merge the data instead of creating a duplicate record. For sourced candidates without an email, set sourced to true. ### What unified data models are available for Teamtailor through Truto? Truto's Unified ATS API exposes six standardized models for Teamtailor: Applications, Attachments, Candidates, Job Interview Stages, Jobs, and Users. These let you read and write data using a consistent schema across multiple ATS providers. ### What write operations are supported for Teamtailor? Truto supports creating and updating jobs, candidates, job applications, notes, and uploads. Notes also support delete and get-by-ID operations. This covers the most common integration patterns including candidate injection, pipeline management, and contextual annotation. ### Does Truto handle Teamtailor's pagination and rate limits automatically? Yes. Truto manages pagination across list endpoints and handles rate-limit retries transparently, so your application receives complete result sets without needing to implement Teamtailor-specific cursor logic or backoff strategies.