> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombo.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Atlas ATS Integration
> Atlas connector for Kombo's ATS API
This connector is in open beta. You can freely enable it in your account.
The Atlas ATS integration allows you to sync ATS data between Atlas and your application through Kombo's unified API. The tool slug for this connector is `atlas`.
## Guides and Resources
Step-by-step instructions to connect your Atlas account to Kombo.
## General Notes
* Atlas is an agency ATS. Projects map to jobs; people attached to projects (candidates) map to applications. Only people who appear on at least one project are synced as candidates.
## Supported Features & Coverage
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| first\_name | |
| last\_name | |
| email | |
| remote\_data | |
| Field | Notes |
| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| job\_code | |
| description | |
| employment\_type | |
| status | Atlas project states `lead`, `pitch`, `opportunity`, and `talent_pool` map to `DRAFT`. `on_hold` maps to `CLOSED`. |
| visibility | |
| experience\_level | |
| remote\_work\_status | |
| location | |
| custom\_fields | |
| integration\_fields | |
| closed\_at | |
| remote\_created\_at | |
| remote\_updated\_at | |
| remote\_data | |
| 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 | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| name | |
| status | |
| remote\_data | |
| 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 | |
| remote\_updated\_at | |
| remote\_data | |
| Field | Notes |
| ------------------------ | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| title | |
| starting\_at | |
| ending\_at | |
| location | |
| video\_conferencing\_url | |
| application\_id | |
| canceled | |
| remote\_created\_at | |
| remote\_updated\_at | |
| remote\_data | |
| Field | Notes |
| ----------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| status | |
| employment\_start\_date | |
| application\_id | |
| custom\_fields | |
| integration\_fields | |
| remote\_created\_at | |
| remote\_updated\_at | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| remote\_label | |
| scope | |
| unified\_type | |
Notes are attached to people (not applications). We ingest manual notes and phone-call notes from POST /people/notes/lookup; application\_id is always unset. On delta syncs, a note is only picked up if the candidate it was added to also changed since the last sync. To get all notes, use a full sync.
| Field | Notes |
| ------------------- | ----- |
| id | |
| remote\_id | |
| changed\_at | |
| remote\_deleted\_at | |
| candidate\_id | |
| author\_id | |
| content\_html | |
| remote\_created\_at | |
| remote\_updated\_at | |
| remote\_data | |
| Field | Notes |
| ------------------- | ----- |
| index | |
| job\_id | |
| stage\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
Atlas assigns each project member a member type.
* **lead** maps to `RECRUITER`
* **member** syncs without a unified role type.
| Field | Notes |
| ------------------- | ----- |
| job\_user\_id | |
| role\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
| Field | Notes |
| ------------------- | ----- |
| roles | |
| job\_id | |
| user\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
| Field | Notes |
| ------------------- | ----- |
| interview\_id | |
| user\_id | |
| id | |
| changed\_at | |
| remote\_deleted\_at | |
If a person with the same email, phone, or LinkedIn already exists in Atlas, the existing person is reused and their profile is not updated. Attachments are stored on the person, not on the candidate/application. CV attachments are uploaded as Atlas `resume`; COVER\_LETTER and OTHER as `other`. Creates are attributed to the Atlas user configured in "Default user email for created people". Atlas rejects writes when the project is closed or on hold. LinkedIn social links are stored as Atlas `linkedin` identities; other social links as `website`.
| Input Field | Notes |
| ----------------------------------------------------- | ----- |
| candidate.first\_name | |
| candidate.last\_name | |
| candidate.email\_address | |
| candidate.additional\_email\_addresses.email\_address | |
| candidate.company | |
| candidate.title | |
| candidate.phone\_number | |
| candidate.additional\_phone\_numbers.phone\_number | |
| candidate.location.city | |
| candidate.location.country | |
| candidate.location.state | |
| candidate.location.street\_1 | |
| candidate.location.zip\_code | |
| candidate.gender | |
| candidate.social\_links.url | |
| application.job\_id | |
| application.stage\_id | |
| attachments.name | |
| attachments.content\_type | |
| attachments.data\_url | |
| attachments.data | |
| attachments.type | |
| source.name | |
| source.unified\_key | |
| source.id | |
If a person with the same email, phone, or LinkedIn already exists in Atlas, the existing person is reused and their profile is not updated. Attachments are stored on the person, not on the candidate/application. CV attachments are uploaded as Atlas `resume`; COVER\_LETTER and OTHER as `other`. Creates are attributed to the Atlas user configured in "Default user email for created people". Atlas rejects writes when the project is closed or on hold. LinkedIn social links are stored as Atlas `linkedin` identities; other social links as `website`.
| Input Field | Notes |
| ----------------------------------------------------- | ----- |
| candidate.first\_name | |
| candidate.last\_name | |
| candidate.email\_address | |
| candidate.additional\_email\_addresses.email\_address | |
| candidate.company | |
| candidate.title | |
| candidate.phone\_number | |
| candidate.additional\_phone\_numbers.phone\_number | |
| candidate.location.city | |
| candidate.location.country | |
| candidate.location.state | |
| candidate.location.street\_1 | |
| candidate.location.zip\_code | |
| candidate.gender | |
| candidate.social\_links.url | |
| application.job\_id | |
| application.stage\_id | |
| attachments.name | |
| attachments.content\_type | |
| attachments.data\_url | |
| attachments.data | |
| attachments.type | |
| source.name | |
| source.unified\_key | |
| source.id | |
Atlas stores attachments on the person (candidate), not on a specific candidate/application. CV attachments are uploaded as Atlas `resume` (CV parsing runs when attached to a person). COVER\_LETTER and OTHER are uploaded as `other`.
| Input Field | Notes |
| ------------------------ | ----- |
| application\_id | |
| attachment.name | |
| attachment.content\_type | |
| attachment.data\_url | |
| attachment.data | |
| attachment.type | |
Moving uses Atlas stage IDs and places the candidate at the first status of that stage. Atlas rejects writes when the project is closed or on hold. A rejected candidate cannot be moved until the rejection is rolled back first.
| Input Field | Notes |
| --------------- | ----- |
| application\_id | |
| stage\_id | |
Atlas stores attachments on the person (candidate), not on a specific candidate/application. This returns all files attached to the candidate.
| Input Field | Notes |
| --------------- | ----- |
| application\_id | |
Atlas stores attachments on the person. Application-specific attachment links are not available, so `application_id` is always null.
| Input Field | Notes |
| ------------- | ----- |
| candidate\_id | |
| Feature | Notes |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Passthrough | |
| Upstream Webhooks | project.created: triggered when a project (job) was created project.updated: triggered when a project (job) was updated including being published or unpublished candidate.stageMoved: triggered when an application stage changed, or a candidate was created when newly added to a project candidate.rejected: triggered when a candidate was rejected from a project pipeline person.updated: triggered when a person (candidate profile) was updated person.created: triggered when a person was created (only applied when they are already on a project) placement.created: triggered when a placement (hire / accepted offer) was created placement.updated: triggered when a placement (hire / accepted offer) was updated Not covered: screening questions updated on a job Not covered: tag assigned to a candidate Not covered: interview scheduled Not covered: interview updated Not covered: person experience created or updated (use person.updated for profile fields) Not covered: person contact created or updated on a company Webhooks are configured manually in Atlas (Settings → Integrations → Webhooks) and delivered via Svix. Not covered: notes created or updated on people. Not covered: client, contract, or financial fee events (no matching Kombo ATS models). |
| Scope Testing | |
| Per Model Tests | |
| Delta Syncs | |
| Source Writing | |
| Sync Only Created Applications | |
| Connection Guide | |
| Roles | |
| Job roles (e.g. Hiring Manager) | Atlas assigns each project member a member type. |
* **lead** maps to `RECRUITER`
* **member** syncs without a unified role type. |