SmartRecruiters ATS Integration
SmartRecruiters connector for Kombo’s ATS API
The SmartRecruiters ATS integration allows you to sync ATS data between SmartRecruiters and your application through Kombo’s unified API. The tool slug for this connector is smartrecruiters
.
Guides and Resources
Connection Setup Guide
Step-by-step instructions to connect your SmartRecruiters account to Kombo.
Source Setup Guide
Learn how to set up candidate sources in SmartRecruiters.
View Candidate Sources
How to view and manage candidate sources in SmartRecruiters.
How to create an integration user in SmartRecruiters
Additional documentation and guides for SmartRecruiters.
Supported Features & Coverage
Users
Users
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
first_name | |
last_name | |
status | |
remote_data |
Jobs
Jobs
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
job_code | |
description | |
employment_type | |
status | |
visibility | |
category | |
department | |
post_url | |
experience_level | |
location | |
custom_fields | |
integration_fields | |
opened_at | |
remote_created_at | |
remote_updated_at | |
remote_data |
Job postings
Job postings
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
description_html | |
status | |
visibility | |
url | |
job_id | |
remote_data | |
remote_created_at |
Candidates
Candidates
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
first_name | |
last_name | |
company | |
title | |
source | |
phone_numbers | |
email_addresses | |
social_media | |
location | |
custom_fields | |
integration_fields | |
remote_created_at | |
remote_updated_at | |
remote_data |
Application Stages
Application Stages
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
global_index |
Applications
Applications
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
outcome | |
rejection_reason_name | |
rejected_at | |
current_stage_id | |
job_id | |
candidate_id | |
custom_fields | |
integration_fields | |
remote_created_at | The remote_created_at field will only be filled when we are syncing the application status history which we are doing to sync rejected_at. |
remote_updated_at | The remote_updated_at field will only be filled when we are syncing the application status history which we are doing to sync rejected_at. Furthermore, it only reflects changes to the application status, not the application itself. |
remote_data |
Screening questions
Screening questions
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
description | |
format |
Tags
Tags
Interviews
Interviews
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
starting_at | |
ending_at | |
location | |
application_id | |
canceled | |
remote_data |
Offers
Offers
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
status | |
application_id | The SmartRecruiters offer model only contains references to the candidate and job. If application_id is enabled in your Kombo scope config, we therefore additionally request the application read scope to retrieve the application ID from the candidate and job. |
custom_fields | |
integration_fields | |
remote_created_at | |
remote_updated_at | |
remote_data |
Rejection reasons
Rejection reasons
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
remote_data |
Candidate tags
Candidate tags
Job-specific screening questions
Job-specific screening questions
Field | Notes |
---|---|
index | |
required | |
precondition_question_id | |
precondition_options | |
job_id | |
question_id | |
id | |
changed_at | |
remote_deleted_at |
Job hiring team members
Job hiring team members
Field | Notes |
---|---|
roles | |
job_id | |
user_id | |
id | |
changed_at | |
remote_deleted_at |
Interviewing team members
Interviewing team members
Field | Notes |
---|---|
interview_id | |
user_id | |
id | |
changed_at | |
remote_deleted_at |
Users
Users
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
first_name | |
last_name | |
status | |
remote_data |
Jobs
Jobs
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
job_code | |
description | |
employment_type | |
status | |
visibility | |
category | |
department | |
post_url | |
experience_level | |
location | |
custom_fields | |
integration_fields | |
opened_at | |
remote_created_at | |
remote_updated_at | |
remote_data |
Job postings
Job postings
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
description_html | |
status | |
visibility | |
url | |
job_id | |
remote_data | |
remote_created_at |
Candidates
Candidates
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
first_name | |
last_name | |
company | |
title | |
source | |
phone_numbers | |
email_addresses | |
social_media | |
location | |
custom_fields | |
integration_fields | |
remote_created_at | |
remote_updated_at | |
remote_data |
Application Stages
Application Stages
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
global_index |
Applications
Applications
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
outcome | |
rejection_reason_name | |
rejected_at | |
current_stage_id | |
job_id | |
candidate_id | |
custom_fields | |
integration_fields | |
remote_created_at | The remote_created_at field will only be filled when we are syncing the application status history which we are doing to sync rejected_at. |
remote_updated_at | The remote_updated_at field will only be filled when we are syncing the application status history which we are doing to sync rejected_at. Furthermore, it only reflects changes to the application status, not the application itself. |
remote_data |
Screening questions
Screening questions
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
description | |
format |
Tags
Tags
Interviews
Interviews
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
title | |
starting_at | |
ending_at | |
location | |
application_id | |
canceled | |
remote_data |
Offers
Offers
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
status | |
application_id | The SmartRecruiters offer model only contains references to the candidate and job. If application_id is enabled in your Kombo scope config, we therefore additionally request the application read scope to retrieve the application ID from the candidate and job. |
custom_fields | |
integration_fields | |
remote_created_at | |
remote_updated_at | |
remote_data |
Rejection reasons
Rejection reasons
Field | Notes |
---|---|
id | |
remote_id | |
changed_at | |
remote_deleted_at | |
name | |
remote_data |
Candidate tags
Candidate tags
Job-specific screening questions
Job-specific screening questions
Field | Notes |
---|---|
index | |
required | |
precondition_question_id | |
precondition_options | |
job_id | |
question_id | |
id | |
changed_at | |
remote_deleted_at |
Job hiring team members
Job hiring team members
Field | Notes |
---|---|
roles | |
job_id | |
user_id | |
id | |
changed_at | |
remote_deleted_at |
Interviewing team members
Interviewing team members
Field | Notes |
---|---|
interview_id | |
user_id | |
id | |
changed_at | |
remote_deleted_at |
Create candidate
Create candidate
read_jobs
permission is required because we need to look up job posting details when creating candidates. SmartRecruiters does not allow setting a stage directly when creating a candidate. Passing the stage_id
parameter to Kombo when creating a candidate will therefore move the candidate to the stage post-creation, and requires the candidate_manage
SmartRecruiters permission. Past candidate experience must be defined with a start date and title within the SmartRecruiters API. Kombo will set the title to ’-’ if only the company field is passed without a title. The start date is set to 2100-01-01 as a dummy value; if you require a different start date, please set it via remote_fields.Input Field | Notes |
---|---|
candidate.first_name | |
candidate.last_name | |
candidate.email_address | |
candidate.company | |
candidate.title | |
candidate.phone_number | |
candidate.location.city | |
candidate.location.country | |
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 | |
attachments.data_url | |
attachments.type | |
source.name | Please note that we can only write sources that your customer has already set up with the exact name (under https://www.smartrecruiters.com/settings/configuration/custom-sources). If you specify a source within the source.name field, we will only use it if it’s already set up within SmartRecruiters and is of the type ‘OTHER’. Otherwise, the source defined in the connection flow is used. |
gdpr_consent.given |
Create application
Create application
read_jobs
permission is required because we need to look up job posting details when creating candidates. SmartRecruiters does not allow setting a stage directly when creating a candidate. Passing the stage_id
parameter to Kombo when creating a candidate will therefore move the candidate to the stage post-creation, and requires the candidate_manage
SmartRecruiters permission. Past candidate experience must be defined with a start date and title within the SmartRecruiters API. Kombo will set the title to ’-’ if only the company field is passed without a title. The start date is set to 2100-01-01 as a dummy value; if you require a different start date, please set it via remote_fields.Input Field | Notes |
---|---|
candidate.first_name | |
candidate.last_name | |
candidate.email_address | |
candidate.company | |
candidate.title | |
candidate.phone_number | |
candidate.location.city | |
candidate.location.country | |
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 | |
attachments.data_url | |
attachments.type | |
source.name | Please note that we can only write sources that your customer has already set up with the exact name (under https://www.smartrecruiters.com/settings/configuration/custom-sources). If you specify a source within the source.name field, we will only use it if it’s already set up within SmartRecruiters and is of the type ‘OTHER’. Otherwise, the source defined in the connection flow is used. |
gdpr_consent.given |
Add tag to candidate
Add tag to candidate
Input Field | Notes |
---|---|
candidate_id | |
tag.name |
Remove tag from candidate
Remove tag from candidate
Input Field | Notes |
---|---|
candidate_id | |
tag.name |
Add attachment to application
Add attachment to application
Input Field | Notes |
---|---|
application_id | |
attachment.name | |
attachment.content_type | |
attachment.data | |
attachment.type |
Move application to stage
Move application to stage
Input Field | Notes |
---|---|
application_id | |
stage_id |
Reject application
Reject application
Input Field | Notes |
---|---|
application_id | |
rejection_reason_id |
Add result link to application
Add result link to application
Input Field | Notes |
---|---|
application_id | |
label | |
url | |
details.attributes.key | |
details.attributes.value |
Add note to application
Add note to application
Input Field | Notes |
---|---|
application_id | |
content |
Get application attachments
Get application attachments
Input Field | Notes |
---|---|
application_id |
Get candidate attachments
Get candidate attachments
Input Field | Notes |
---|---|
candidate_id |
Add attachment to candidate
Add attachment to candidate
Input Field | Notes |
---|---|
candidate_id | |
attachment.name | |
attachment.content_type | |
attachment.data | |
attachment.type |
Add result link to candidate
Add result link to candidate
Input Field | Notes |
---|---|
candidate_id | |
label | |
url | |
details.attributes.key | |
details.attributes.value |
Feature | Notes |
---|---|
Source Writing | |
Sync Only Created Applications | |
Connection Guide | |
Prerequisites | |
Candidate source tracking | |
OAuth | |
API Passthrough | |
Scope Testing | |
Delta Syncs | |
Custom Field Explorer | |
Candidates |
Integration Variants
Other variants are:
- SmartRecruiters Assessment SmartRecruiters for the Assessment category