100Hires - AI ATS & Recruitment Software

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.

Create an application form, optionally attaching existing questions.

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

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

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

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

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

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

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

Permanently delete an application.

Permanently delete a candidate.

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

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

Delete an application form.

Delete a job.

Delete a job webhook.

Cancel a scheduled message before it is sent.

Delete a note.

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

Soft-delete a nurture campaign; running executions stop.

Delete a reusable question from the catalog.

Delete a company-scoped webhook.

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

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.

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

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

Get billing and feature flags of the current company.

Get a candidate with application summaries.

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

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

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.

Get a company profile with owner details.

Get an email template with its subject and body.

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

Get a form with its questions and their statuses.

Get an interview by id.

Get a job by id or alias.

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

Get a note with its author and visibility.

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

Get a nurture campaign with all steps and schedule settings.

Get a question with its type and options.

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

Get the stages of one workflow.

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

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

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

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 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.

List job boards available for publishing.

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.

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

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.

List a candidate's tags.

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

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

List global job categories.

List companies accessible to the partner API key.

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

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

List departments of the company.

List education level values.

List email templates of a company.

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

List experience level values.

List application forms of a company.

List users on the job's hiring team.

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

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

List webhooks subscribed to this job's events.

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

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

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

List discussion notes of a candidate.

List nurture campaigns with their steps.

List candidate origin values.

List supported question types.

List the reusable question catalog of the company.

List rejection reasons configured for the company.

List candidate sources of the company.

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

List all tags of the company.

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

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

List company users with their roles.

List company-scoped webhook subscriptions.

List pipeline stages, filtered by workflow or job.

List workflows of the company with their stages.

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

Partially update a scheduled message before it is sent.

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

Queue the job for publication on the given boards.

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

Remove one tag from a candidate.

Deactivate the job's publication on the given boards.

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

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

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.

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

Change job status (publish, unpublish, archive).

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

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

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

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

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

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

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

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

Update an email template; omitted fields keep their values.

Update a form's name and question composition.

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

Update a job. Send only the fields to change.

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

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

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

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

Update the text, type or options of a question.

Upload a base64-encoded file as an application 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.

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.