100Hires - AI ATS & Recruitment Software

List candidates filtered by job, stage, email, name, LinkedIn or dates. Prefer size <= 10.

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.

Get a candidate with application summaries.

Update candidate fields, profile answers or resume text. For an attached resume pass the parsed text via resume_text; never inline binary data.

Permanently delete a candidate.

List a candidate's tags.

Add tags to a candidate.

Remove one tag from a candidate.

Add tags to up to 100 candidates; returns per-item results.

Remove tags from up to 100 candidates; returns per-item results.

List a candidate's files (resume and other documents): uuid, download url, file metadata, type.

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.

Get a candidate's primary resume: uuid, download url, file metadata, type. include=text_content adds the parsed plain text.

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.

Reject all active applications of a candidate; returns the affected application ids.

List a candidate's interviews across all applications.

List a candidate's email history; is_scheduled=1 returns only pending scheduled messages. Prefer size <= 10.

Schedule an email to a candidate; without scheduled_at it is sent 15 minutes after creation.

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.

Link an existing candidate to a job, creating an application.

Get an application with its stage, status and rejection context.

Update application fields. stage_id performs a full stage transition with the target stage's automation, like hires_move_application.

Permanently delete an application.

Move an application to a specific pipeline stage; stage ids come from the job's pipeline_stages.

Advance an application to the next stage in workflow order; no stage_id needed.

Mark an application as hired: status becomes hired and hired_at is set.

Reject an application, optionally with a reason and without the rejection email.

Reopen a rejected application: status returns to active and rejected_at is cleared.

Transfer an application to another job by creating a new application there, optionally at a given stage.

Get the AI score of an application with per-criterion scores, justifications and follow-up questions; null score until scored.

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.

List an application's attachments with file metadata and download URLs.

Upload a base64-encoded file as an application attachment.

List filled evaluation forms of an application with evaluator, summary score (strong-yes to strong-no) and summary text.

Schedule an interview for an application. The location is matched to an existing record or created.

Move up to 100 applications to a stage in one request; per-item results, partial success allowed.

Reject up to 100 applications in one request, optionally with a reason; per-item results, partial success allowed.

List jobs filtered by status, creation/update time, department or search query.

Create a job. Required: status, title, description, location_country; location_city unless is_remote is true.

Get a job by id or alias.

Update a job. Send only the fields to change.

Delete a job.

Change job status (publish, unpublish, archive).

List job boards the job is published to, with their state.

Queue the job for publication on the given boards.

Deactivate the job's publication on the given boards.

Get board publication states for several jobs at once.

Queue several jobs for publication on the given boards.

Deactivate publication of several jobs on the given boards.

List users on the job's hiring team.

Add a company user to the job's hiring team.

List webhooks subscribed to this job's events.

Register an HTTPS webhook for this job's events. Returns signing_secret once; use it to verify the x-hires-signature-v2 header.

Delete a job webhook.

Rotate the signing secret; the new one is returned once, the old stays valid for a grace window.

List outbound messages (sent and scheduled) of one mail account; received mail is not included.

Get a scheduled message with sender account, schedule timestamps and cancelability.

Replace a scheduled message before it is sent; all required fields must be provided.

Partially update a scheduled message before it is sent.

Cancel a scheduled message before it is sent.

Create up to 100 scheduled messages in one request; items are processed independently, one failure does not stop the others.

Get a notification email (e.g. a rejection email): subject, body, sender, recipient, schedule. Ids come from hires_list_candidate_messages.

Update the subject, body or send time of a scheduled notification email; sent messages cannot be changed.

Cancel a scheduled notification email; sent messages cannot be canceled.

Cancel all scheduled notification emails of a candidate; sent ones are unaffected.

List interviews filtered by job, application, candidate, interviewer, date or timestamps. Pass include=candidate so the agenda widget can link cards to candidate profiles.

Get an interview by id.

List discussion notes of a candidate.

Create a discussion note for a candidate, with optional visibility (all or private) and @mentions that email the mentioned users.

Get a note with its author and visibility.

Update a note's body or visibility in place, without a new timeline item.

Delete a note.

Get a filled evaluation form: evaluator, summary score and text, answers.

List application forms of a company.

Create an application form, optionally attaching existing questions.

Get a form with its questions and their statuses.

Update a form's name and question composition.

Delete an application form.

Set a question's status (required, optional, hidden) on a form.

List email templates of a company.

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.

Get an email template with its subject and body.

Update an email template; omitted fields keep their values.

Soft-delete an email template; automations that used it cannot pick it for new actions.

List nurture campaigns with their steps.

Create a nurture campaign with ordered steps (email, sms, voicemail, move_to_next_stage, assign_tag, assign_task), optionally triggered by a workflow stage.

Get a nurture campaign with all steps and schedule settings.

Update a nurture campaign. Send the full steps list: existing steps with their id, removed steps with is_deleted=true.

Soft-delete a nurture campaign; running executions stop.

List company users with their roles.

Get a user by id. Its default_mail_account_id can serve as from_account_id when sending emails.

List a user's connected mail accounts; use one as from_account_id when sending messages.

List companies accessible to the partner API key.

Create a client company; provisions its public career site (slug) and public branding (name, logo).

Get a company profile with owner details.

Update a company profile, owner contacts or logo; name, slug and logo changes alter the public career site.

Soft-delete a company; its public career site goes offline.

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.

Set the public career site language; job and company pages follow it unless a job overrides it.

List mail accounts of all users in the current company; use to resolve from_account_id for messages.

List mail accounts of all users in a given company (own or client).

Restore a soft-deleted company; its public career site comes back online.

List company-scoped webhook subscriptions.

Create a company-scoped webhook. signing_secret is returned once; use it to verify the x-hires-signature-v2 header on deliveries.

Delete a company-scoped webhook.

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.

List candidate sources of the company.

List candidate origin values.

List rejection reasons configured for the company.

List job status labels (draft, published, on_hold, closed, archived).

List career site locales (e.g. de-DE) accepted by language parameters; is_default marks the one used when none is picked.

List departments of the company.

List global job categories.

List education level values.

List experience level values.

List employment types (full-time, part-time, contract, etc.).

List job boards available for publishing.

List all tags of the company.

List workflows of the company with their stages.

List pipeline stages, filtered by workflow or job.

Get the stages of one workflow.

List the reusable question catalog of the company.

Create a reusable question; options apply to select/multiselect types.

Get a question with its type and options.

Update the text, type or options of a question.

Delete a reusable question from the catalog.

List supported question types.

List email template placeholders; pass the chosen one to hires_prepare_template_placeholders to get its HTML tag.

Convert a placeholder reference into the HTML tag to insert into an email template body.

Get billing and feature flags of the current company.

Submit feedback about the API: missing features, issues, improvements. Rate limit: 5 per hour.

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.

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.

List public jobs of a company career site, filterable by department, employment type, city and country.

Get a public job with salary, education and experience levels; 404 for draft, archived or internal jobs.

Submit a career site application: creates the candidate and runs the pipeline automation.