Available Connectors
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
SmartRecruiters does not validate email addresses. Kombo will sync all users, but only return emails that have been validated.
| 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
SmartRecruiters will continue to reference inactive or deleted 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
SmartRecruiters does not validate email addresses. Kombo will sync all users, but only return emails that have been validated.
| 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
SmartRecruiters will continue to reference inactive or deleted 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
The
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
The
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
The SmartRecruiters ‘add attachment to candidate’ endpoint is deprecated. Please prefer to use Kombo’s ‘add attachment to application’ endpoint.
| 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
The SmartRecruiters ‘add attachment to candidate’ endpoint is deprecated. Please prefer to use Kombo’s ‘add attachment to application’ endpoint.
| 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