This connector is in open beta. You can freely enable it in your account.
mercury.
Guides and Resources
Connection Setup Guide
Step-by-step instructions to connect your Mercury account to Kombo.
Supported Features & Coverage
- Models
- Actions
- Features
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 | |
| weekly_hours | |
| employment_type | |
| status | |
| department | |
| salary_amount | |
| salary_currency | |
| salary_period | |
| location | |
| custom_fields | |
| integration_fields | |
| opened_at | |
| remote_created_at | |
| remote_updated_at | |
| contact_id | |
| remote_data |
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 |
Applications
Applications
| Field | Notes |
|---|---|
| id | |
| remote_id | |
| changed_at | |
| remote_deleted_at | |
| outcome | Mercury shortlists expose statusReason/subStatus strings, not a HIRED/DECLINED/PENDING outcome. |
| current_stage_id | Mercury shortlists expose statusReason/subStatus strings that are not yet mapped to unified stages. |
| job_id | |
| candidate_id | |
| 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 |
Roles
Roles
| Field | Notes |
|---|---|
| id | |
| remote_id | |
| changed_at | |
| remote_deleted_at | |
| remote_label | |
| scope | |
| unified_type |
Job user role assignments
Job user role assignments
Mercury exposes a single hiring manager and a single consultant (recruiter) per vacancy.
- hiringManager maps to unified type
HIRING_MANAGER - consultant maps to unified type
RECRUITER
| Field | Notes |
|---|---|
| job_user_id | |
| role_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 |
Create candidate
Create candidate
Does not create a Mercury applicant. Creates a contact and a shortlist record linking the contact to the vacancy.
| 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.location.state | |
| candidate.location.street_1 | |
| candidate.location.zip_code | |
| candidate.gender | |
| candidate.availability_date | |
| candidate.salary_expectations.period | |
| candidate.salary_expectations.amount | |
| candidate.social_links.url | |
| application.job_id | |
| attachments.name | |
| attachments.content_type | |
| attachments.data_url | |
| attachments.data | |
| attachments.type | |
| source.name | |
| sourced_by.user_id |
Create application
Create application
Does not create a Mercury applicant. Creates a contact and a shortlist record linking the contact to the vacancy.
| 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.location.state | |
| candidate.location.street_1 | |
| candidate.location.zip_code | |
| candidate.gender | |
| candidate.availability_date | |
| candidate.salary_expectations.period | |
| candidate.salary_expectations.amount | |
| candidate.social_links.url | |
| application.job_id | |
| attachments.name | |
| attachments.content_type | |
| attachments.data_url | |
| attachments.data | |
| attachments.type | |
| source.name | |
| sourced_by.user_id |
Add attachment to application
Add attachment to application
Mercury stores uploaded files on the candidate contact, not on a specific application. CV attachments go to the CV folder; non-CV attachments go to the general documents folder. CV attachments are stored in the CV folder of the contact. Non-CV attachments are stored in a general documents folder.
| Input Field | Notes |
|---|---|
| application_id | |
| attachment.name | |
| attachment.content_type | |
| attachment.data_url | |
| attachment.data | |
| attachment.type |
Move application to stage
Move application to stage
Currently only supports moving Mercury applicants to stages, and not Mercury shortlists, due to a temporary Mercury API limitation.
| Input Field | Notes |
|---|---|
| application_id | |
| stage_id |
Reject application
Reject application
Mercury does not have structured rejection reasons. Rejecting sets the applicant status to “Unsuitable” (status 2). Rejection notes are not supported by the Mercury reject endpoint.
| Input Field | Notes |
|---|---|
| application_id |
Add result link to application
Add result link to application
Mercury does not have a native result link feature. Result links are stored as annotations on the candidate contact.
| Input Field | Notes |
|---|---|
| application_id | |
| label | |
| url | |
| details.custom_field_name_prefix | |
| details.attributes.key | |
| details.attributes.value |
Add note to application
Add note to application
Mercury stores notes on the candidate contact, not on a specific application.
| Input Field | Notes |
|---|---|
| application_id | |
| content |
Get candidate attachments
Get candidate attachments
| Input Field | Notes |
|---|---|
| candidate_id |
Add attachment to candidate
Add attachment to candidate
CV attachments are stored in the CV folder of the contact. Non-CV attachments are stored in a general documents folder.
| Input Field | Notes |
|---|---|
| candidate_id | |
| attachment.name | |
| attachment.content_type | |
| attachment.data_url | |
| attachment.data | |
| attachment.type |
Add result link to candidate
Add result link to candidate
Mercury does not have a native result link feature. Result links are stored as annotations on the candidate contact.
| Input Field | Notes |
|---|---|
| candidate_id | |
| label | |
| url | |
| details.custom_field_name_prefix | |
| details.attributes.key | |
| details.attributes.value |
| Feature | Notes |
|---|---|
| API Passthrough | |
| Delta Syncs | |
| Custom Field Explorer | |
| Jobs | |
| Candidates | |
| Source Writing | |
| Sync Only Created Applications | |
| Connection Guide | |
| Create Candidate Full Attachment Retry | |
| Candidate Cutoff Filtering | |
| Roles | |
| Job roles (e.g. Hiring Manager) | Mercury exposes a single hiring manager and a single consultant (recruiter) per vacancy. |
- hiringManager maps to unified type
HIRING_MANAGER - consultant maps to unified type
RECRUITER|