Teamtailor ATS Integration

The Teamtailor ATS integration allows you to sync ATS data between Teamtailor and your application through Kombo’s unified API. The tool slug for this connector is teamtailor.

Guides and Resources

Connection Setup Guide

Step-by-step instructions to connect your Teamtailor account to Kombo.

Sandbox Environment

Access the Teamtailor sandbox environment for testing and development.

View Candidate Sources

How to view and manage candidate sources in Teamtailor.

Supported Features & Coverage

Models
Actions
Features

Users

Field	Notes
id
remote_id
changed_at
remote_deleted_at
first_name
last_name
email
remote_data

Jobs

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
description
employment_type
status
visibility
department
post_url
experience_level
remote_work_status
salary_amount_from
salary_amount_to
salary_currency
salary_period
location
custom_fields
integration_fields
remote_url
opened_at
closed_at
remote_created_at
remote_updated_at
remote_data

Job postings

Field	Notes
id
remote_id
changed_at
remote_deleted_at
title
description_html
status
visibility
job_id
remote_data
remote_created_at
remote_updated_at

Candidates

We only expose one location per candidate.

Field	Notes
id
remote_id
changed_at
remote_deleted_at
first_name
last_name
confidential
source
phone_numbers
email_addresses
social_media
location
custom_fields
integration_fields
remote_url
remote_created_at
remote_updated_at
remote_data

Application Stages

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name

Applications

Field	Notes
id
remote_id
changed_at
remote_deleted_at
outcome
rejection_reason_name
rejected_at
current_stage_id
job_id
candidate_id
screening_question_answers
custom_fields
integration_fields
remote_url
remote_created_at
remote_data

Screening questions

Field	Notes
id
remote_id
changed_at
remote_deleted_at
title
description
format

Tags

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name

Offers

Field	Notes
id
remote_id
changed_at
remote_deleted_at
status
employment_start_date
custom_fields
integration_fields
remote_created_at
remote_data

Rejection reasons

Field	Notes
id
remote_id
changed_at
remote_deleted_at
name
remote_data

Roles

Field	Notes
id
remote_id
changed_at
remote_deleted_at
remote_label
scope
unified_type

Candidate tags

Field	Notes
candidate_id
tag_id
id
changed_at
remote_deleted_at

Job-specific application stages

Field	Notes
index
job_id
stage_id
id
changed_at
remote_deleted_at

Job-specific screening questions

Field	Notes
index
required
precondition_question_id
precondition_options
job_id
question_id
id
changed_at
remote_deleted_at

Job user role assignments

Teamtailor exposes hiring team members via two relations on the job:

user (shown as “Recruiter” in the UI) maps to unified type RECRUITER
team-memberships exposes 2 types of roles
team-memberships shown as “External Recruiter” in the UI maps to unified type RECRUITER
team-memberships shown as “Additional Users” in the UI have no unified type

Field	Notes
job_user_id
role_id
id
changed_at
remote_deleted_at

Job hiring team members

Field	Notes
roles
job_id
user_id
id
changed_at
remote_deleted_at

User roles

Teamtailor exposes each user’s role attribute

admin maps to unified type ADMIN
recruiter maps to unified type RECRUITER
external_recruiter maps to unified type RECRUITER
Any other role value has no unified type.

Field	Notes
user_id
role_id
id
changed_at
remote_deleted_at

Create candidate

It is not possible to answer screening questions of type ‘file’ via the Teamtailor API. The submitted answers will be uploaded as other attachments instead. Teamtailor only supports LinkedIn as a social link. Other links will be ignored.

Input Field	Notes
candidate.first_name
candidate.last_name
candidate.email_address
candidate.title
candidate.phone_number
candidate.social_links.url
application.job_id
application.stage_id
screening_question_answers.question_id
screening_question_answers.answer
attachments.name
attachments.content_type
attachments.data_url
attachments.data
attachments.type
source.name
source.unified_key
source.id
gdpr_consent.given

Create application

Input Field	Notes
candidate.first_name
candidate.last_name
candidate.email_address
candidate.title
candidate.phone_number
candidate.social_links.url
application.job_id
application.stage_id
screening_question_answers.question_id
screening_question_answers.answer
attachments.name
attachments.content_type
attachments.data_url
attachments.data
attachments.type
source.name
source.unified_key
source.id
gdpr_consent.given

Add tag to candidate

Parallel use of this action is not recommended for Teamtailor.

Input Field	Notes
candidate_id
tag.name

Remove tag from candidate

Parallel use of this action is not recommended for Teamtailor.

Input Field	Notes
candidate_id
tag.name

Add attachment to application

It’s not possible to add new “CV”s. Every CV attachment that is added will have type “other” inside TeamTailor. This action will fall back to the “Add attachment to candidate” action. Therefore, there could be cases where the attachment may not be added to the application but rather to the candidate.

Input Field	Notes
application_id
attachment.name
attachment.content_type
attachment.data_url
attachment.data

Move application to stage

Input Field	Notes
application_id
stage_id

Reject application

When rejecting an application, Teamtailor shows it as rejected by “Deleted User” in the API. You can however specify a user id under remote_fields.teamtailor.user_id to provide an author for the note behind the rejection.

Input Field	Notes
application_id
rejection_reason_id
note

Add result link to application

In Teamtailor, we can not write additional details to the result link. We can only write the URL and label.

Input Field	Notes
application_id
label
url

Add note to application

To write a note, we need to select a valid admin user. We automatically select the first admin user in the system. You can overwrite this by submitting a valid user ID at remote_fields?.teamtailor?.user_id to this endpoint.

Input Field	Notes
application_id
content

Get application attachments

Input Field	Notes
application_id

Get candidate attachments

Input Field	Notes
candidate_id

Add attachment to candidate

It’s not possible to add new “CV”s. Every CV attachment that is added will have type “other” inside TeamTailor.

Input Field	Notes
candidate_id
attachment.name
attachment.content_type
attachment.data_url
attachment.data

Add result link to candidate

In Teamtailor, we can not write additional details to the result link. We can only write the URL and label.

Input Field	Notes
candidate_id
label
url

Feature	Notes
API Passthrough
Webhook Subscriptions	candidate.create: triggered when a candidate was created candidate.destroy: triggered when a candidate was deleted candidate.update: triggered when a candidate was updated job_application.create: triggered when a job application was created job_application.destroy: triggered when a job application was deleted job_application.update: triggered when a job application was updated including stage changed job.create: triggered when a job was created job.destroy: triggered when a job was deleted job.update: triggered when a job was updated including being published or unpublished user.create: triggered when a user with access to the Teamtailor dashboard was created user.destroy: triggered when a user with access to the Teamtailor dashboard was deleted user.update: triggered when a user with access to the Teamtailor dashboard was updated Not covered: a tag was assigned or removed from a candidate Not covered: an interview was scheduled or updated Not covered: screening questions were updated for a job
Scope Testing
Delta Syncs
Custom Field Explorer
Jobs
Source Writing
Sync Only Created Applications
Connection Guide
Prerequisites
Create credentials
Candidate Cutoff Filtering
Roles
System roles (e.g. Admin)	Teamtailor exposes each user’s role attribute

admin maps to unified type ADMIN
recruiter maps to unified type RECRUITER
external_recruiter maps to unified type RECRUITER
Any other role value has no unified type. | | Job roles (e.g. Hiring Manager) | Teamtailor exposes hiring team members via two relations on the job:
user (shown as “Recruiter” in the UI) maps to unified type RECRUITER
team-memberships exposes 2 types of roles
team-memberships shown as “External Recruiter” in the UI maps to unified type RECRUITER
team-memberships shown as “Additional Users” in the UI have no unified type |

Integration Variants

Current connector: Choose this variant if you want to use the full Teamtailor ATS integration with comprehensive read/write capabilities for jobs, candidates, applications, and more For Teamtailor, we also offer the following other connector variants:

Teamtailor Job Boards

Choose this variant if you are a job board partner who wants to receive job postings and send applications to Teamtailor’s Job Board API. This variant has limited functionality compared to the full ATS integration but integrations are automatically created when your customer posts a job within Teamtailor.

Teamtailor Assessment

Teamtailor for the Assessment category

Multiple variants can be used within your Kombo environment at the same time.

General

Features

Guides

ATS API Reference

General API Reference

Teamtailor ATS Integration

Guides and Resources

Connection Setup Guide

Sandbox Environment

View Candidate Sources

Supported Features & Coverage

Integration Variants

Teamtailor Job Boards

Teamtailor Assessment

​Guides and Resources

Connection Setup Guide

Sandbox Environment

View Candidate Sources

​Supported Features & Coverage

​Integration Variants

Teamtailor Job Boards

Teamtailor Assessment

Guides and Resources

Supported Features & Coverage

Integration Variants