Skip to content

ATS

Teamtailor
API integration

Ship ATS features without building the integration. Full Teamtailor API access via Proxy, normalized data through Unified APIs, and 10+ MCP-ready tools for AI agents — all extensible to your exact use case.

Talk to us
Teamtailor

Use Cases

Why integrate with Teamtailor

Common scenarios for SaaS companies building Teamtailor integrations for their customers.

01

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.

02

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.

03

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.

04

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.

05

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

Ship these features with Truto + Teamtailor

Concrete product features your team can ship faster by leveraging Truto’s Teamtailor integration instead of building from scratch.

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

SuperAI

Teamtailor AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

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.

Why Truto

Why use Truto’s MCP server for Teamtailor

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 650+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

Unified APIs

Unified APIs for Teamtailor

Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.

Unified ATS API

Applications

The applications represent an application for a job.

View Docs

Attachments

The attachments represent an attachment for a candidate.

View Docs

Candidates

The candidates represent a candidate.

View Docs

Job Interview Stages

The job interview stages represent a job interview stage.

View Docs

Jobs

The jobs represent a job.

View Docs

Users

The users represent a user.

View Docs

How It Works

From zero to integrated

Go live with Teamtailor in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Teamtailor account

Use Truto’s frontend SDK to connect your customer’s Teamtailor account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Teamtailor

Truto’s Proxy API is a 1-to-1 mapping of the Teamtailor API. You call us, we call Teamtailor, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Teamtailor’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Teamtailor on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

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.

Teamtailor

Get Teamtailor integrated into your app

Our team understands what it takes to make a Teamtailor integration successful. A short, crisp 30 minute call with folks who understand the problem.

Talk to us