MCP Radar
MCP Server

100Hires - AI ATS & Recruitment Software

com.100hires/100hires
Business & Operations Public & reachable MCP 2025-11-25

What this MCP does

Manages recruiting workflows including candidates, jobs, applications, interviews, hiring teams, forms, messaging, automations, and job-board publishing.

Capabilities

Tools

136 tools
hires_add_candidate_tags
Add tags to a candidate.
Input schema 
{'type': 'object', 'required': ['id', 'tags'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}}}
hires_add_hiring_team_member
Add a company user to the job's hiring team.
Input schema 
{'type': 'object', 'required': ['id', 'user_id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'user_id': {'type': 'number'}}}
hires_advance_application
Advance application to next stage
Advance an application to the next stage in workflow order; no stage_id needed.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job. Pass candidate,job so the widget can link to the candidate and job pages'}}}
hires_batch_add_tags
Add tags to up to 100 candidates; returns per-item results.
Input schema 
{'type': 'object', 'required': ['ids', 'tags'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Candidate ids'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}}}
hires_batch_create_messages
Create up to 100 scheduled messages in one request; items are processed independently, one failure does not stop the others.
Open world
Input schema 
{'type': 'object', 'required': ['messages'], 'properties': {'messages': {'type': 'array', 'items': {'type': 'object', 'required': ['candidate_id', 'to', 'subject', 'body'], 'properties': {'cc': {'type': 'array', 'items': {'type': 'string'}}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recipient emails'}, 'bcc': {'type': 'array', 'items': {'type': 'string'}}, 'body': {'type': 'string', 'description': 'HTML'}, 'subject': {'type': 'string'}, 'candidate_id': {'type': 'integer'}, 'scheduled_at': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Unix seconds; default now + 900'}, 'application_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'from_account_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': "Default: API key owner's default mail account"}, 'reply_to_email_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Mailbox message id to reply to'}, 'send_in_new_thread': {'type': 'boolean', 'description': 'Start a new thread instead of replying'}}}, 'maxItems': 100}}}
hires_batch_job_boards
Get board publication states for several jobs at once.
Read only
Input schema 
{'type': 'object', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Job ids'}}}
hires_batch_move_applications
Move up to 100 applications to a stage in one request; per-item results, partial success allowed.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['ids', 'stage_id'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Max 100'}, 'stage_id': {'type': 'number'}}}
hires_batch_publish_to_boards
Queue several jobs for publication on the given boards.
Open world
Input schema 
{'type': 'object', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Job ids'}, 'boards': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. indeed, linkedin'}}}
hires_batch_reject_applications
Reject up to 100 applications in one request, optionally with a reason; per-item results, partial success allowed.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Max 100'}, 'rejection_reason_id': {'type': 'number', 'description': 'From hires_list_rejection_reasons'}}}
hires_batch_remove_from_boards
Deactivate publication of several jobs on the given boards.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['jobs'], 'properties': {'jobs': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Job ids'}, 'boards': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. indeed, linkedin'}}}
hires_batch_remove_tags
Remove tags from up to 100 candidates; returns per-item results.
Destructive
Input schema 
{'type': 'object', 'required': ['ids', 'tags'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Candidate ids'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}}}
hires_cancel_all_notification_messages
Cancel all scheduled notification emails of a candidate; sent ones are unaffected.
Destructive
Input schema 
{'type': 'object', 'required': ['candidate_id'], 'properties': {'candidate_id': {'anyOf': [{'type': 'integer'}, {'type': 'string'}], 'description': 'Candidate id or alias'}}}
hires_create_application
Link an existing candidate to a job, creating an application.
Open world
Input schema 
{'type': 'object', 'required': ['candidate_id', 'job_id'], 'properties': {'cv': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. application/pdf'}}}, 'job_id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}, 'stage_id': {'type': 'number', 'description': 'Defaults to the first stage'}, 'candidate_id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_create_candidate
Create a candidate, optionally with an application (job_id, stage_id) and resume text. Parse an attached resume yourself and pass the text via resume_text; never inline binary data.
Input schema 
{'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'Also used to resolve timezone'}, 'email': {'type': 'string', 'description': 'Used for deduplication'}, 'phone': {'type': 'string'}, 'state': {'type': 'string'}, 'job_id': {'type': 'number', 'description': 'Creates an application for this job'}, 'country': {'type': 'string', 'description': 'Name or ISO code'}, 'profile': {'type': 'object', 'description': 'Profile answers keyed by question text or question_id'}, 'stage_id': {'type': 'number', 'description': 'Initial stage; requires job_id'}, 'timezone': {'type': 'string', 'description': 'IANA, e.g. America/Los_Angeles; resolved from city and country if omitted'}, 'last_name': {'type': 'string'}, 'company_id': {'type': 'number'}, 'first_name': {'type': 'string'}, 'resume_text': {'type': 'string', 'description': 'Plain text extracted from the resume; stored as a text/plain attachment. No binary or base64.'}}}
hires_create_company
Create a client company; provisions its public career site (slug) and public branding (name, logo).
Open world
Input schema 
{'type': 'object', 'required': ['name', 'company_owner_email', 'company_owner_name'], 'properties': {'url': {'type': 'string', 'description': 'Company profile URL'}, 'logo': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. image/png'}}}, 'name': {'type': 'string'}, 'website': {'type': 'string'}, 'company_owner_name': {'type': 'string'}, 'is_staffing_agency': {'type': 'boolean'}, 'company_owner_email': {'type': 'string'}, 'company_owner_phone': {'type': 'string'}}}
hires_create_email_template
Create an email template. Subject and body accept placeholders such as {{first_name}}; get the exact tags from hires_list_template_placeholders and hires_prepare_template_placeholders.
Input schema 
{'type': 'object', 'required': ['name', 'subject', 'body'], 'properties': {'body': {'type': 'string', 'description': 'HTML; placeholders allowed'}, 'name': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'Placeholders allowed'}, 'company_id': {'type': 'number'}}}
hires_create_form
Create an application form, optionally attaching existing questions.
Open world
Input schema 
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Question ids to attach'}, 'company_id': {'type': 'number'}}}
hires_create_interview
Schedule an interview for an application. The location is matched to an existing record or created.
Input schema 
{'type': 'object', 'required': ['id', 'start_time', 'end_time', 'interviewer_ids'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, application, job'}, 'end_time': {'type': 'number', 'description': 'Unix seconds, after start_time'}, 'location': {'type': 'string', 'description': 'Free text'}, 'start_time': {'type': 'number', 'description': 'Unix seconds'}, 'interviewer_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Interviewer user ids'}}}
hires_create_job
Create a job. Required: status, title, description, location_country; location_city unless is_remote is true.
Open world
Input schema 
{'type': 'object', 'required': ['status', 'title', 'description', 'location_country'], 'properties': {'title': {'type': 'string'}, 'status': {'type': 'string', 'description': 'From hires_list_statuses, e.g. Draft, Public'}, 'form_id': {'type': 'number', 'description': 'Omitted = new form named after the job'}, 'include': {'type': 'string', 'description': 'Embed: workflow, hiring_team, pipeline_stages'}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 35, 'minLength': 1}, {'type': 'null'}], 'description': 'Job page locale, e.g. de-DE; null = follow the career site language. Values: hires_list_languages'}, 'is_remote': {'type': 'boolean', 'description': 'Remote job; with empty city, state and postal code Indeed posts it nationwide'}, 'company_id': {'type': 'number'}, 'salary_max': {'type': 'number'}, 'salary_min': {'type': 'number'}, 'category_id': {'type': 'number', 'description': 'From hires_list_categories'}, 'description': {'type': 'string', 'description': 'HTML allowed'}, 'workflow_id': {'type': 'number', 'description': 'Omitted = new workflow named after the job'}, 'department_id': {'type': 'number', 'description': 'From hires_list_departments'}, 'location_city': {'type': 'string', 'description': 'Required unless is_remote; empty = nationwide remote posting on Indeed'}, 'parent_job_id': {'type': 'number', 'description': 'Parent job; makes this a satellite job'}, 'salary_period': {'enum': ['annually', 'monthly', 'daily', 'hourly'], 'type': 'string'}, 'internal_title': {'type': 'string', 'description': 'Hiring team only'}, 'location_state': {'type': 'string'}, 'internal_job_id': {'type': 'string', 'description': 'External reference id'}, 'salary_currency': {'type': 'string', 'description': 'ISO code, e.g. USD'}, 'location_country': {'type': 'string'}, 'education_level_id': {'type': 'number', 'description': 'From hires_list_education_levels'}, 'employment_type_id': {'type': 'number', 'description': 'From hires_list_employment_types'}, 'knockout_questions': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'expected_answer', 'disqualify_on_wrong_answer'], 'properties': {'text': {'type': 'string', 'description': 'Shown to the applicant'}, 'expected_answer': {'enum': ['Yes', 'No'], 'type': 'string'}, 'disqualify_on_wrong_answer': {'type': 'boolean', 'description': 'Disqualify on wrong answer'}}}, 'description': 'Yes/No screening questions added to the application form'}, 'ai_scoring_criteria': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'weight'], 'properties': {'id': {'type': 'integer', 'description': 'Existing criterion id; omit to create', 'exclusiveMinimum': 0}, 'text': {'type': 'string', 'description': 'What to evaluate'}, 'title': {'type': 'string'}, 'weight': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Relative importance'}}}, 'description': 'AI scoring criteria for ranking applicants'}, 'experience_level_id': {'type': 'number', 'description': 'From hires_list_experience_levels'}, 'resume_field_status': {'enum': ['required', 'optional', 'hidden'], 'type': 'string'}, 'location_postal_code': {'type': 'string'}, 'location_full_address': {'type': 'string'}, 'location_street_address': {'type': 'string'}}}
hires_create_job_webhook
Register an HTTPS webhook for this job's events. Returns signing_secret once; use it to verify the x-hires-signature-v2 header.
Open world
Input schema 
{'type': 'object', 'required': ['id', 'url'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'url': {'type': 'string', 'description': 'HTTPS URL on a public host (no localhost, private or link-local IPs)'}}}
hires_create_note
Create note
Create a discussion note for a candidate, with optional visibility (all or private) and @mentions that email the mentioned users.
Input schema 
{'type': 'object', 'required': ['candidate_id', 'body'], 'properties': {'body': {'type': 'string', 'description': 'HTML allowed'}, 'include': {'type': 'string', 'description': 'Embed: user (author), candidate. Pass candidate so the widget can link to the candidate profile'}, 'user_id': {'type': 'number', 'description': 'Author; defaults to the authenticated user'}, 'visibility': {'type': 'string', 'description': 'all (default) or private'}, 'candidate_id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'mention_user_ids': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Mentioned users get an email'}}}
hires_create_nurture_campaign
Create a nurture campaign with ordered steps (email, sms, voicemail, move_to_next_stage, assign_tag, assign_task), optionally triggered by a workflow stage.
Open world
Input schema 
{'type': 'object', 'required': ['title', 'steps'], 'properties': {'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'delay_days', 'send_condition'], 'properties': {'id': {'type': 'number', 'description': 'Existing step id (update only)'}, 'type': {'enum': ['email', 'sms', 'voicemail', 'move_to_next_stage', 'assign_tag', 'assign_task'], 'type': 'string'}, 'sender': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'number'}, 'type': {'type': 'string', 'description': 'account or user'}}, 'description': 'email (required)'}, 'tag_id': {'type': 'number', 'description': 'assign_tag (required)'}, 'priority': {'type': 'number', 'description': 'assign_task'}, 'stage_id': {'type': 'number', 'description': 'move_to_next_stage (required)'}, 'assignees': {'type': 'array', 'items': {'type': 'number'}, 'description': 'assign_task (required): user ids'}, 'delay_days': {'type': 'number', 'minimum': 0, 'description': 'Days to wait before this step'}, 'is_deleted': {'type': 'boolean', 'description': 'Update only: true removes the step'}, 'schedule_id': {'type': 'number', 'description': 'email, sms, voicemail: sending schedule id'}, 'template_id': {'type': 'number', 'description': 'email, sms (required)'}, 'is_new_thread': {'type': 'boolean', 'description': 'email: send as a new thread'}, 'send_condition': {'enum': ['if_no_reply', 'if_no_reply_but_opened'], 'type': 'string'}, 'sender_user_id': {'type': 'number', 'description': 'sms (required)'}, 'attachment_uuid': {'type': 'string', 'format': 'uuid', 'description': 'voicemail (required): uuid from hires_upload_attachment, category voicemail'}, 'due_in_interval': {'type': 'string', 'description': 'assign_task: ISO-8601 duration, e.g. P3D'}, 'task_template_id': {'type': 'number', 'description': 'assign_task (required)'}, 'is_send_by_carousel': {'type': 'boolean', 'description': 'email, sms: rotate sender accounts'}}}, 'description': 'Executed in order. Each field names the step types that use it and whether it is required there.'}, 'title': {'type': 'string'}, 'stage_id': {'type': 'number', 'description': 'Stage that triggers the campaign'}, 'timezone': {'type': 'string', 'description': 'IANA timezone, e.g. America/New_York'}, 'company_id': {'type': 'number'}, 'delay_time': {'type': 'number', 'description': 'Delay before the first step, seconds (max 86400); wins over relative_days + relative_time if both are sent'}, 'send_to_all': {'type': 'boolean', 'description': 'Send to all candidates in the stage, not only new ones (default false)'}, 'workflow_id': {'type': 'number', 'description': 'Workflow the campaign is bound to'}, 'relative_days': {'type': 'number', 'description': 'Days after the trigger for the first step; use with relative_time'}, 'relative_time': {'type': 'number', 'description': 'Time of day for the first step, seconds from midnight'}, 'response_move_to_stage_id': {'type': 'number', 'description': 'Stage to move a candidate to when they reply'}}}
hires_create_question
Create a reusable question; options apply to select/multiselect types.
Input schema 
{'type': 'object', 'required': ['text', 'type'], 'properties': {'text': {'type': 'string'}, 'type': {'type': 'string', 'description': 'From hires_list_question_types'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer options for select/multiselect types'}, 'company_id': {'type': 'number'}}}
hires_create_webhook
Create a company-scoped webhook. signing_secret is returned once; use it to verify the x-hires-signature-v2 header on deliveries.
Open world
Input schema 
{'type': 'object', 'required': ['id', 'url'], 'properties': {'id': {'type': 'number', 'description': 'Company id'}, 'url': {'type': 'string', 'description': 'HTTPS URL on a public host (no localhost, private or link-local IPs)'}}}
hires_delete_application
Permanently delete an application.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_candidate
Permanently delete a candidate.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_delete_company
Soft-delete a company; its public career site goes offline.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_email_template
Soft-delete an email template; automations that used it cannot pick it for new actions.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_form
Delete an application form.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_job
Delete a job.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}}}
hires_delete_job_webhook
Delete a job webhook.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'webhook_id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'webhook_id': {'type': 'number'}}}
hires_delete_message
Cancel a scheduled message before it is sent.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer'}}}
hires_delete_note
Delete a note.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_notification_message
Cancel a scheduled notification email; sent messages cannot be canceled.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer'}}}
hires_delete_nurture_campaign
Soft-delete a nurture campaign; running executions stop.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_question
Delete a reusable question from the catalog.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_delete_webhook
Delete a company-scoped webhook.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'webhook_id'], 'properties': {'id': {'type': 'number', 'description': 'Company id'}, 'webhook_id': {'type': 'number'}}}
hires_disqualify_candidate
Reject all active applications of a candidate; returns the affected application ids.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'reasons': {'type': 'array', 'items': {'type': ['number', 'string']}, 'description': 'Rejection reason ids from hires_list_rejection_reasons'}}}
hires_download_attachment
Download an attachment (resume, candidate or application file, mail attachment, call recording) by the url another tool returned. Returns file_name, mime_type, size and base64 data; files over 25 MB are rejected.
Read only
Input schema 
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': "Absolute url from another tool's response; must be on the 100Hires API host"}}}
hires_get_ai_score
Get the AI score of an application with per-criterion scores, justifications and follow-up questions; null score until scored.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_application
Get an application with its stage, status and rejection context.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}}}
hires_get_billing
Get billing and feature flags of the current company.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_get_candidate
Get candidate
Get a candidate with application summaries.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_get_candidate_resume
Get a candidate's primary resume: uuid, download url, file metadata, type. include=text_content adds the parsed plain text.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'include': {'type': 'string', 'description': 'text_content: add the parsed plain text'}}}
hires_get_career_job
Get a public job with salary, education and experience levels; 404 for draft, archived or internal jobs.
Read only
Input schema 
{'type': 'object', 'required': ['company_slug', 'id'], 'properties': {'id': {'type': 'number'}, 'company_slug': {'type': 'string'}}}
hires_get_career_site_settings
Get career site settings: language is the locale the public site renders in (null = en-US); a job may override it with its own language field.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number', 'description': "Omit for the API key's own company"}}}
hires_get_company
Get a company profile with owner details.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_email_template
Get an email template with its subject and body.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_evaluation
Get a filled evaluation form: evaluator, summary score and text, answers.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_form
Get a form with its questions and their statuses.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_interview
Get an interview by id.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, application, job'}}}
hires_get_job
Get job
Get a job by id or alias.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'include': {'type': 'string', 'description': 'Embed: workflow, hiring_team, pipeline_stages'}}}
hires_get_message
Get a scheduled message with sender account, schedule timestamps and cancelability.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer'}}}
hires_get_note
Get a note with its author and visibility.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: user (author), candidate'}}}
hires_get_notification_message
Get a notification email (e.g. a rejection email): subject, body, sender, recipient, schedule. Ids come from hires_list_candidate_messages.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer'}}}
hires_get_nurture_campaign
Get a nurture campaign with all steps and schedule settings.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_question
Get a question with its type and options.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_user
Get a user by id. Its default_mail_account_id can serve as from_account_id when sending emails.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_get_workflow_stages
Get the stages of one workflow.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number', 'description': 'Workflow id'}, 'company_id': {'type': 'number'}}}
hires_hire_application
Mark an application as hired: status becomes hired and hired_at is set.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}}}
hires_list_application_attachments
List an application's attachments with file metadata and download URLs.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_list_application_evaluations
List filled evaluation forms of an application with evaluator, summary score (strong-yes to strong-no) and summary text.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary replaces summary_text with a 200-char summary_text_preview'}}}
hires_list_applications
List applications (pipeline view)
List applications across accessible jobs with filters by candidate, job, stage, status, AI score and dates. Each item embeds its current stage, so a pipeline view needs no extra job call.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'sort': {'enum': ['created_at', '-created_at', 'ai_score', '-ai_score', 'last_message_at', '-last_message_at'], 'type': 'string', 'description': 'Default -created_at'}, 'job_id': {'type': 'number'}, 'status': {'enum': ['pending', 'hired', 'rejected'], 'type': 'string'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text. Pass candidate for pipeline rendering (names instead of ids)'}, 'stage_id': {'type': 'number', 'description': 'Best combined with job_id'}, 'company_id': {'type': 'number'}, 'ai_score_max': {'type': 'number'}, 'ai_score_min': {'type': 'number'}, 'candidate_id': {'type': 'number'}, 'created_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601'}, 'updated_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601; for incremental sync'}}}
hires_list_application_stage_history
Chronological stage transitions of an application, including the initial assignment: from/to stage, moved_at, moved_by_type (system, user, automation), moved_by_user_id and source. Prefer it over candidate activities for stage reports.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_list_boards
List job boards available for publishing.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_candidate_activities
List a candidate's timeline events. Prefer size <= 10. event_type values: comment, copilot_response, stage_moved, automation_action_triggered, assign_job, enrichment, call, validate_emails, profile_mutation, qualification, assign_tags, assign_sources, candidate_rate.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'page': {'type': 'number'}, 'size': {'type': 'number', 'description': 'Default 20, max 100'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary replaces copilot text, call transcription and comment body with 200-char *_preview fields'}, 'since': {'type': ['number', 'string'], 'description': 'Inclusive; Unix seconds or ISO-8601'}, 'until': {'type': ['number', 'string'], 'description': 'Inclusive; Unix seconds or ISO-8601'}, 'event_type': {'type': 'string', 'description': 'Comma-separated; values listed in the tool description'}}}
hires_list_candidate_files
List a candidate's files (resume and other documents): uuid, download url, file metadata, type.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_list_candidate_interviews
List a candidate's interviews across all applications.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}}}
hires_list_candidate_messages
List a candidate's email history; is_scheduled=1 returns only pending scheduled messages. Prefer size <= 10.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary omits the HTML body and attachment metadata'}, 'is_scheduled': {'type': 'number', 'const': 1}}}
hires_list_candidates
Search candidates
List candidates filtered by job, stage, email, name, LinkedIn or dates. Prefer size <= 10.
Read only
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Partial match on name or email'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary omits the profile answers array'}, 'email': {'type': 'string', 'description': 'Exact match'}, 'job_id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: applications (job titles and stages)'}, 'linkedin': {'type': 'string', 'description': 'LinkedIn profile URL or alias'}, 'stage_id': {'type': 'number', 'description': 'Pipeline stage id; combine with job_id'}, 'full_name': {'type': 'string'}, 'company_id': {'type': 'number'}, 'created_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601'}, 'updated_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601; for incremental sync'}}}
hires_list_candidate_tags
List a candidate's tags.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_list_career_jobs
List public jobs of a company career site, filterable by department, employment type, city and country.
Read only
Input schema 
{'type': 'object', 'required': ['company_slug'], 'properties': {'city': {'type': 'string', 'description': 'Exact match'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'country': {'type': 'string', 'description': 'Exact match'}, 'company_slug': {'type': 'string'}, 'department_id': {'type': 'number'}, 'employment_type_id': {'type': 'number'}}}
hires_list_categories
List global job categories.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_companies
List companies accessible to the partner API key.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}}}
hires_list_company_id_mail_accounts
List mail accounts of all users in a given company (own or client).
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}}}
hires_list_company_mail_accounts
List mail accounts of all users in the current company; use to resolve from_account_id for messages.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}}}
hires_list_departments
List departments of the company.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number'}}}
hires_list_education_levels
List education level values.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_email_templates
List email templates of a company.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary omits the HTML body'}, 'company_id': {'type': 'number'}}}
hires_list_employment_types
List employment types (full-time, part-time, contract, etc.).
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_experience_levels
List experience level values.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_forms
List application forms of a company.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary omits the questions array'}, 'company_id': {'type': 'number'}}}
hires_list_hiring_team
List users on the job's hiring team.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}}}
hires_list_interviews
List interviews (agenda)
List interviews filtered by job, application, candidate, interviewer, date or timestamps. Pass include=candidate so the agenda widget can link cards to candidate profiles.
Read only
Input schema 
{'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'YYYY-MM-DD, UTC'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'job_id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, application, job'}, 'company_id': {'type': 'number'}, 'candidate_id': {'type': 'number'}, 'created_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601'}, 'updated_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601; for incremental sync'}, 'application_id': {'type': 'number'}, 'interviewer_user_id': {'type': 'number'}}}
hires_list_job_boards
List job boards the job is published to, with their state.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}}}
hires_list_jobs
List jobs
List jobs filtered by status, creation/update time, department or search query.
Read only
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Search title or internal title'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary'}, 'status': {'type': 'string', 'description': 'From hires_list_statuses, e.g. Public, Draft, Archived'}, 'include': {'type': 'string', 'description': 'Embed: workflow, hiring_team, pipeline_stages'}, 'company_id': {'type': 'number'}, 'department_id': {'type': 'number', 'description': 'From hires_list_departments'}, 'updated_after': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601; for incremental sync'}, 'created_at_end': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601'}, 'created_at_start': {'type': ['number', 'string'], 'description': 'Unix seconds or ISO-8601'}}}
hires_list_job_webhooks
List webhooks subscribed to this job's events.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}}}
hires_list_languages
List career site locales (e.g. de-DE) accepted by language parameters; is_default marks the one used when none is picked.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_messages
List outbound messages (sent and scheduled) of one mail account; received mail is not included.
Read only
Input schema 
{'type': 'object', 'required': ['from_account_id'], 'properties': {'page': {'type': 'integer', 'minimum': 1}, 'size': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Default 20'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary'}, 'status': {'enum': ['scheduled', 'sent', 'all'], 'type': 'string', 'description': 'Default: all'}, 'date_to': {'type': 'integer', 'description': 'Unix seconds'}, 'date_from': {'type': 'integer', 'description': 'Unix seconds; filters on scheduled/sent time'}, 'from_account_id': {'type': 'integer', 'description': 'Mail account id from hires_list_company_mail_accounts or hires_list_user_mail_accounts'}}}
hires_list_notes
List discussion notes of a candidate.
Read only
Input schema 
{'type': 'object', 'required': ['candidate_id'], 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'view': {'enum': ['summary', 'full'], 'type': 'string', 'default': 'summary', 'description': 'summary replaces the body with a 200-char body_preview'}, 'include': {'type': 'string', 'description': 'Embed: user (author), candidate'}, 'candidate_id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}}}
hires_list_nurture_campaigns
List nurture campaigns with their steps.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'company_id': {'type': 'number'}}}
hires_list_origins
List candidate origin values.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_questions
List the reusable question catalog of the company.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'company_id': {'type': 'number'}}}
hires_list_question_types
List supported question types.
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_rejection_reasons
List rejection reasons configured for the company.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number'}}}
hires_list_sources
List candidate sources of the company.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number'}}}
hires_list_statuses
List job status labels (draft, published, on_hold, closed, archived).
Read only
Input schema 
{'type': 'object', 'properties': {}}
hires_list_tags
List all tags of the company.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number'}}}
hires_list_template_placeholders
List email template placeholders; pass the chosen one to hires_prepare_template_placeholders to get its HTML tag.
Read only
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'description': 'Label substring, case-insensitive'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}, 'type': {'enum': ['profile_field', 'job_variable', 'questionnaire_link', 'self_scheduling_link'], 'type': 'string'}, 'company_id': {'type': 'number'}, 'is_notification': {'type': 'number', 'description': '1 includes notification-only system placeholders (default 0)'}}}
hires_list_user_mail_accounts
List a user's connected mail accounts; use one as from_account_id when sending messages.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number', 'description': 'User id'}, 'page': {'type': 'number'}, 'size': {'type': 'number'}}}
hires_list_users
List company users with their roles.
Read only
Input schema 
{'type': 'object', 'properties': {'page': {'type': 'number'}, 'size': {'type': 'number'}, 'company_id': {'type': 'number'}}}
hires_list_webhooks
List company-scoped webhook subscriptions.
Read only
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number', 'description': 'Company id'}}}
hires_list_workflows
List workflows of the company with their stages.
Read only
Input schema 
{'type': 'object', 'properties': {'company_id': {'type': 'number'}}}
hires_list_workflow_stages
List pipeline stages, filtered by workflow or job.
Read only
Input schema 
{'type': 'object', 'properties': {'job_id': {'type': 'number', 'description': "Stages of the job's assigned workflow"}, 'company_id': {'type': 'number'}, 'workflow_id': {'type': 'number', 'description': 'Workflow id from hires_list_workflows'}}}
hires_move_application
Move an application to a specific pipeline stage; stage ids come from the job's pipeline_stages.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'stage_id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}, 'stage_id': {'type': 'number'}}}
hires_patch_message
Partially update a scheduled message before it is sent.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'cc': {'type': 'array', 'items': {'type': 'string'}}, 'id': {'type': 'integer'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recipient emails'}, 'bcc': {'type': 'array', 'items': {'type': 'string'}}, 'body': {'type': 'string', 'description': 'HTML'}, 'subject': {'type': 'string'}, 'scheduled_at': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Unix seconds'}, 'from_account_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': "Default: API key owner's default mail account"}, 'reply_to_email_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Mailbox message id to reply to'}, 'send_in_new_thread': {'type': 'boolean', 'description': 'Send as a new thread'}}}
hires_prepare_template_placeholders
Convert a placeholder reference into the HTML tag to insert into an email template body.
Read only
Input schema 
{'type': 'object', 'required': ['type'], 'properties': {'type': {'type': 'string', 'description': 'system, candidate_column, job_variable, questionnaire_link or scheduling_link'}, 'identifier': {'type': 'string'}, 'job_variable_id': {'type': 'number'}, 'form_question_id': {'type': 'number'}, 'system_column_title': {'type': 'string'}, 'qas_profile_question_id': {'type': 'number', 'description': 'Profile question id'}}}
hires_publish_to_job_board
Queue the job for publication on the given boards.
Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'boards': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. indeed, linkedin'}}}
hires_reject_application
Reject an application, optionally with a reason and without the rejection email.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}, 'rejection_reason_id': {'type': 'number', 'description': 'From hires_list_rejection_reasons'}, 'suppress_notification': {'type': 'boolean', 'description': 'Skip the rejection email to the candidate'}}}
hires_remove_candidate_tag
Remove one tag from a candidate.
Destructive
Input schema 
{'type': 'object', 'required': ['id', 'tag'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'tag': {'type': 'string'}}}
hires_remove_from_job_board
Deactivate the job's publication on the given boards.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'boards': {'type': 'array', 'items': {'type': 'string'}, 'description': 'e.g. indeed, linkedin'}}}
hires_restore_company
Restore a soft-deleted company; its public career site comes back online.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}}}
hires_rotate_job_webhook_secret
Rotate the signing secret; the new one is returned once, the old stays valid for a grace window.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'webhook_id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'webhook_id': {'type': 'number'}}}
hires_rotate_webhook_secret
Rotate a company webhook signing secret with zero downtime: the new signing_secret is returned once and the old one stays valid for a grace window.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'webhook_id'], 'properties': {'id': {'type': 'number', 'description': 'Company id'}, 'webhook_id': {'type': 'number'}}}
hires_send_candidate_message
Schedule an email to a candidate; without scheduled_at it is sent 15 minutes after creation.
Open world
Input schema 
{'type': 'object', 'required': ['id', 'to', 'subject', 'body'], 'properties': {'cc': {'type': 'array', 'items': {'type': 'string'}}, 'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recipient emails'}, 'bcc': {'type': 'array', 'items': {'type': 'string'}}, 'body': {'type': 'string', 'description': 'HTML'}, 'subject': {'type': 'string'}, 'scheduled_at': {'type': ['number', 'null'], 'description': 'Unix seconds; default: now + 15 min'}, 'application_id': {'type': ['number', 'null']}, 'from_account_id': {'type': ['number', 'null'], 'description': "Mail account id; default: the API key owner's default account"}, 'reply_to_email_id': {'type': ['number', 'null'], 'description': 'Mailbox message id to reply to'}, 'send_in_new_thread': {'type': 'boolean', 'description': 'Start a new thread instead of replying'}}}
hires_set_job_status
Change job status (publish, unpublish, archive).
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'status'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'status': {'type': 'string', 'description': 'From hires_list_statuses, e.g. Draft, Public, Archived'}, 'include': {'type': 'string', 'description': 'Embed: workflow, hiring_team, pipeline_stages'}}}
hires_submit_career_application
Submit a career site application: creates the candidate and runs the pipeline automation.
Open world
Input schema 
{'type': 'object', 'required': ['company_slug', 'job_id', 'first_name', 'last_name', 'email'], 'properties': {'email': {'type': 'string'}, 'phone': {'type': ['string', 'null']}, 'job_id': {'type': 'number'}, 'resume': {'anyOf': [{'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. application/pdf'}}}, {'type': 'null'}]}, 'source': {'type': ['string', 'null'], 'description': 'Source identifier'}, 'answers': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}], 'description': 'Form answer objects'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'company_slug': {'type': 'string'}, 'linkedin_url': {'type': ['string', 'null']}}}
hires_submit_feedback
Submit feedback about the API: missing features, issues, improvements. Rate limit: 5 per hour.
Input schema 
{'type': 'object', 'required': ['description'], 'properties': {'context': {'type': 'object', 'description': 'Any JSON, max 4 KB'}, 'endpoint': {'type': 'string', 'description': 'e.g. /v2/candidates'}, 'issue_type': {'enum': ['missing_filter', 'pagination', 'performance', 'missing_field', 'bulk_operation', 'other'], 'type': 'string'}, 'description': {'type': 'string', 'description': 'Max 2000 chars'}, 'suggested_improvement': {'type': 'string', 'description': 'Max 2000 chars'}}}
hires_transfer_application
Transfer an application to another job by creating a new application there, optionally at a given stage.
Open world
Input schema 
{'type': 'object', 'required': ['id', 'job_id'], 'properties': {'id': {'type': 'number'}, 'job_id': {'type': 'number', 'description': 'Target job'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}, 'stage_id': {'type': 'number', 'description': 'Stage on the target job; defaults to its first stage'}}}
hires_unreject_application
Reopen a rejected application: status returns to active and rejected_at is cleared.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}}}
hires_update_application
Update application fields. stage_id performs a full stage transition with the target stage's automation, like hires_move_application.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'cv': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. application/pdf'}}, 'description': 'Replace or attach a CV'}, 'id': {'type': 'number'}, 'include': {'type': 'string', 'description': 'Embed: candidate, cv.text, job'}, 'stage_id': {'type': 'number', 'description': 'Target stage; runs its workflow automation'}, 'is_disqualified': {'type': 'boolean'}}}
hires_update_candidate
Update candidate fields, profile answers or resume text. For an attached resume pass the parsed text via resume_text; never inline binary data.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'city': {'type': 'string', 'description': 'Also used to resolve timezone'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'state': {'type': 'string'}, 'job_id': {'type': 'number', 'description': 'Creates a new application for this job'}, 'country': {'type': 'string', 'description': 'Name or ISO code'}, 'profile': {'type': 'object', 'description': 'Profile answers keyed by question text or question_id'}, 'stage_id': {'type': 'number', 'description': 'Stage for that application; requires job_id'}, 'timezone': {'type': 'string', 'description': 'IANA, e.g. America/Los_Angeles; resolved from city and country if omitted'}, 'last_name': {'type': 'string'}, 'first_name': {'type': 'string'}, 'resume_text': {'type': 'string', 'description': 'Plain text extracted from the resume; stored as a text/plain attachment. No binary or base64.'}}}
hires_update_career_site_settings
Set the public career site language; job and company pages follow it unless a job overrides it.
Destructive Open world
Input schema 
{'type': 'object', 'properties': {'language': {'anyOf': [{'type': 'string', 'maxLength': 35, 'minLength': 1}, {'type': 'null'}], 'description': 'Locale, e.g. de-DE; values from hires_list_languages. Omit to keep, null to reset to en-US'}, 'company_id': {'type': 'number', 'description': "Omit for the API key's own company"}}}
hires_update_company
Update a company profile, owner contacts or logo; name, slug and logo changes alter the public career site.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'url': {'type': 'string', 'description': 'Company profile URL'}, 'logo': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. image/png'}}}, 'name': {'type': 'string'}, 'website': {'type': 'string'}, 'company_owner_name': {'type': 'string'}, 'is_staffing_agency': {'type': 'boolean'}, 'company_owner_email': {'type': 'string'}, 'company_owner_phone': {'type': 'string'}}}
hires_update_email_template
Update an email template; omitted fields keep their values.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'body': {'type': 'string', 'description': 'HTML; placeholders allowed'}, 'name': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'Placeholders allowed'}}}
hires_update_form
Update a form's name and question composition.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'name'], 'properties': {'id': {'type': 'number'}, 'name': {'type': 'string'}, 'questions': {'type': 'array', 'items': {'type': 'number'}, 'description': 'Question ids to attach'}}}
hires_update_form_question
Set a question's status (required, optional, hidden) on a form.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['form_id', 'question_id', 'status'], 'properties': {'status': {'enum': ['required', 'optional', 'hidden'], 'type': 'string'}, 'form_id': {'type': 'number'}, 'question_id': {'type': 'number'}}}
hires_update_job
Update a job. Send only the fields to change.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Job id or alias'}, 'title': {'type': 'string'}, 'status': {'type': 'string', 'description': 'From hires_list_statuses, e.g. Draft, Public'}, 'form_id': {'type': 'number', 'description': 'Application form to assign'}, 'include': {'type': 'string', 'description': 'Embed: workflow, hiring_team, pipeline_stages'}, 'language': {'anyOf': [{'type': 'string', 'maxLength': 35, 'minLength': 1}, {'type': 'null'}], 'description': 'Job page locale, e.g. de-DE; null = follow the career site language, omit = keep current. Values: hires_list_languages'}, 'is_remote': {'type': 'boolean', 'description': 'Remote job; with empty city, state and postal code Indeed posts it nationwide'}, 'salary_max': {'type': 'number'}, 'salary_min': {'type': 'number'}, 'category_id': {'type': 'number', 'description': 'From hires_list_categories'}, 'description': {'type': 'string', 'description': 'HTML allowed'}, 'workflow_id': {'type': 'number', 'description': 'Workflow to assign'}, 'department_id': {'type': 'number', 'description': 'From hires_list_departments'}, 'location_city': {'type': 'string', 'description': 'Empty string clears it; remote without city = nationwide posting on Indeed'}, 'parent_job_id': {'type': 'number', 'description': 'Parent job; makes this a satellite job'}, 'salary_period': {'enum': ['annually', 'monthly', 'daily', 'hourly'], 'type': 'string'}, 'internal_title': {'type': 'string', 'description': 'Hiring team only'}, 'location_state': {'type': 'string'}, 'internal_job_id': {'type': 'string', 'description': 'External reference id'}, 'salary_currency': {'type': 'string', 'description': 'ISO code, e.g. USD'}, 'location_country': {'type': 'string'}, 'education_level_id': {'type': 'number', 'description': 'From hires_list_education_levels'}, 'employment_type_id': {'type': 'number', 'description': 'From hires_list_employment_types'}, 'knockout_questions': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'expected_answer', 'disqualify_on_wrong_answer'], 'properties': {'text': {'type': 'string', 'description': 'Shown to the applicant'}, 'expected_answer': {'enum': ['Yes', 'No'], 'type': 'string'}, 'disqualify_on_wrong_answer': {'type': 'boolean', 'description': 'Disqualify on wrong answer'}}}, 'description': 'Yes/No screening questions added to the application form'}, 'ai_scoring_criteria': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'weight'], 'properties': {'id': {'type': 'integer', 'description': 'Existing criterion id; omit to create', 'exclusiveMinimum': 0}, 'text': {'type': 'string', 'description': 'What to evaluate'}, 'title': {'type': 'string'}, 'weight': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Relative importance'}}}, 'description': 'Diff-replace by id: with id update, without id create, absent ones are removed; [] detaches all; omit to keep'}, 'experience_level_id': {'type': 'number', 'description': 'From hires_list_experience_levels'}, 'resume_field_status': {'enum': ['required', 'optional', 'hidden'], 'type': 'string'}, 'location_postal_code': {'type': 'string'}, 'location_full_address': {'type': 'string'}, 'location_street_address': {'type': 'string'}}}
hires_update_message
Replace a scheduled message before it is sent; all required fields must be provided.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'to', 'subject', 'body'], 'properties': {'cc': {'type': 'array', 'items': {'type': 'string'}}, 'id': {'type': 'integer'}, 'to': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recipient emails'}, 'bcc': {'type': 'array', 'items': {'type': 'string'}}, 'body': {'type': 'string', 'description': 'HTML'}, 'subject': {'type': 'string'}, 'scheduled_at': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Unix seconds'}, 'from_account_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': "Default: API key owner's default mail account"}, 'reply_to_email_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Mailbox message id to reply to'}, 'send_in_new_thread': {'type': 'boolean', 'description': 'Send as a new thread'}}}
hires_update_note
Update a note's body or visibility in place, without a new timeline item.
Destructive
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'number'}, 'body': {'type': 'string', 'description': 'HTML allowed'}, 'include': {'type': 'string', 'description': 'Embed: user (author), candidate'}, 'visibility': {'type': 'string', 'description': 'all (default) or private'}}}
hires_update_notification_message
Update the subject, body or send time of a scheduled notification email; sent messages cannot be changed.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'subject', 'body'], 'properties': {'id': {'type': 'integer'}, 'body': {'type': 'string', 'description': 'HTML'}, 'subject': {'type': 'string'}, 'scheduled_at': {'anyOf': [{'type': 'integer'}, {'type': 'null'}], 'description': 'Unix seconds; omit to keep the current schedule'}}}
hires_update_nurture_campaign
Update a nurture campaign. Send the full steps list: existing steps with their id, removed steps with is_deleted=true.
Destructive Open world
Input schema 
{'type': 'object', 'required': ['id', 'title', 'steps'], 'properties': {'id': {'type': 'number'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'delay_days', 'send_condition'], 'properties': {'id': {'type': 'number', 'description': 'Existing step id (update only)'}, 'type': {'enum': ['email', 'sms', 'voicemail', 'move_to_next_stage', 'assign_tag', 'assign_task'], 'type': 'string'}, 'sender': {'type': 'object', 'required': ['type', 'id'], 'properties': {'id': {'type': 'number'}, 'type': {'type': 'string', 'description': 'account or user'}}, 'description': 'email (required)'}, 'tag_id': {'type': 'number', 'description': 'assign_tag (required)'}, 'priority': {'type': 'number', 'description': 'assign_task'}, 'stage_id': {'type': 'number', 'description': 'move_to_next_stage (required)'}, 'assignees': {'type': 'array', 'items': {'type': 'number'}, 'description': 'assign_task (required): user ids'}, 'delay_days': {'type': 'number', 'minimum': 0, 'description': 'Days to wait before this step'}, 'is_deleted': {'type': 'boolean', 'description': 'Update only: true removes the step'}, 'schedule_id': {'type': 'number', 'description': 'email, sms, voicemail: sending schedule id'}, 'template_id': {'type': 'number', 'description': 'email, sms (required)'}, 'is_new_thread': {'type': 'boolean', 'description': 'email: send as a new thread'}, 'send_condition': {'enum': ['if_no_reply', 'if_no_reply_but_opened'], 'type': 'string'}, 'sender_user_id': {'type': 'number', 'description': 'sms (required)'}, 'attachment_uuid': {'type': 'string', 'format': 'uuid', 'description': 'voicemail (required): uuid from hires_upload_attachment, category voicemail'}, 'due_in_interval': {'type': 'string', 'description': 'assign_task: ISO-8601 duration, e.g. P3D'}, 'task_template_id': {'type': 'number', 'description': 'assign_task (required)'}, 'is_send_by_carousel': {'type': 'boolean', 'description': 'email, sms: rotate sender accounts'}}}, 'description': 'Executed in order. Each field names the step types that use it and whether it is required there.'}, 'title': {'type': 'string'}, 'stage_id': {'type': 'number', 'description': 'Stage that triggers the campaign'}, 'timezone': {'type': 'string', 'description': 'IANA timezone, e.g. America/New_York'}, 'delay_time': {'type': 'number', 'description': 'Delay before the first step, seconds (max 86400); wins over relative_days + relative_time if both are sent'}, 'send_to_all': {'type': 'boolean', 'description': 'Send to all candidates in the stage, not only new ones (default false)'}, 'workflow_id': {'type': 'number', 'description': 'Workflow the campaign is bound to'}, 'relative_days': {'type': 'number', 'description': 'Days after the trigger for the first step; use with relative_time'}, 'relative_time': {'type': 'number', 'description': 'Time of day for the first step, seconds from midnight'}, 'response_move_to_stage_id': {'type': 'number', 'description': 'Stage to move a candidate to when they reply'}}}
hires_update_question
Update the text, type or options of a question.
Destructive
Input schema 
{'type': 'object', 'required': ['id', 'text', 'type'], 'properties': {'id': {'type': 'number'}, 'text': {'type': 'string'}, 'type': {'type': 'string', 'description': 'From hires_list_question_types'}, 'options': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Answer options for select/multiselect types'}}}
hires_upload_application_attachment
Upload a base64-encoded file as an application attachment.
Input schema 
{'type': 'object', 'required': ['id', 'file'], 'properties': {'id': {'type': 'number'}, 'file': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 file content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. application/pdf'}}}}}
hires_upload_attachment
Upload a base64 file as an attachment. voicemail: wav/mp3, max 20 MB, no object_id, the returned uuid serves as attachment_uuid in nurture voicemail steps. Returns uuid, url, file, relative_time.
Open world
Input schema 
{'type': 'object', 'required': ['category', 'file'], 'properties': {'file': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string', 'description': 'With extension, e.g. greeting.mp3'}, 'mime_type': {'type': 'string', 'description': 'e.g. audio/mpeg, application/pdf'}}}, 'category': {'enum': ['voicemail', 'candidate', 'application', 'candidate_comment', 'job_note', 'company_favicon', 'company_header', 'company_link_preview'], 'type': 'string', 'description': 'Determines allowed extensions and the object_id owner type'}, 'object_id': {'type': ['number', 'null'], 'description': 'Owner id per category: candidate, application, comment, job note or company; omit for voicemail'}, 'company_id': {'type': ['number', 'null'], 'description': 'Company that owns object_id; default: the authenticated company'}}}
hires_upload_candidate_file
Upload a base64 file to a candidate. Hosts truncate tool arguments above ~20 KB, so for resumes prefer resume_text in hires_create_candidate or hires_update_candidate.
Input schema 
{'type': 'object', 'required': ['id', 'file'], 'properties': {'id': {'type': ['string', 'number'], 'description': 'Candidate id or alias'}, 'file': {'type': 'object', 'required': ['data', 'file_name', 'mime_type'], 'properties': {'data': {'type': 'string', 'description': 'Base64 content'}, 'size': {'type': 'number', 'description': 'Bytes'}, 'file_name': {'type': 'string'}, 'mime_type': {'type': 'string', 'description': 'e.g. application/pdf'}}}}}
History

Recent tool changes

Added
hires_submit_career_application
Sept. 17, 2026, 7:58 a.m.
Added
hires_get_career_job
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_career_jobs
Sept. 17, 2026, 7:58 a.m.
Added
hires_upload_attachment
Sept. 17, 2026, 7:58 a.m.
Added
hires_download_attachment
Sept. 17, 2026, 7:58 a.m.
Added
hires_submit_feedback
Sept. 17, 2026, 7:58 a.m.
Added
hires_get_billing
Sept. 17, 2026, 7:58 a.m.
Added
hires_prepare_template_placeholders
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_template_placeholders
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_question_types
Sept. 17, 2026, 7:58 a.m.
Added
hires_delete_question
Sept. 17, 2026, 7:58 a.m.
Added
hires_update_question
Sept. 17, 2026, 7:58 a.m.
Added
hires_get_question
Sept. 17, 2026, 7:58 a.m.
Added
hires_create_question
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_questions
Sept. 17, 2026, 7:58 a.m.
Added
hires_get_workflow_stages
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_workflow_stages
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_workflows
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_tags
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_boards
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_employment_types
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_experience_levels
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_education_levels
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_categories
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_departments
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_languages
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_statuses
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_rejection_reasons
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_origins
Sept. 17, 2026, 7:58 a.m.
Added
hires_list_sources
Sept. 17, 2026, 7:58 a.m.
Discover

Similar MCP servers

AdButler

com.adbutler/mcp-server

Manages AdButler advertisers, campaigns, ad items, audiences, zones, creatives, catalogs, and advertising reports.

Duvo MCP

io.github.duvoai/duvo

Provides governed retail and CPG operations for cases, queues, approvals, automations, process documentation, integrations, and a…

Lovie Company Formation

co.lovie/company-formation

Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…

freedom-mcp

com.getfreedomos/freedom-mcp

Supports company operations through commitments, teams, agents, customer evidence, leads, content workflows, spreadsheets, commer…

独行录 / opcmenu

io.github.yzlee/opcmenu

Supports founder and company discovery, collaboration goals and tasks, events and signups, networking, messaging, profiles, produ…

Meta Council

com.meta-council/decision-intelligence

Provides governed workflows for consulting, outreach, sales deals, invoices, marketing campaigns, content approvals, accounting a…

synter-ads

io.github.Synter-Media-AI/synter-ads

Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…

synter-ads

io.github.jshorwitz/synter-ads

Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…