100Hires - AI ATS & Recruitment Software

Add one or more tags to a candidate. Used for campaign tagging, qualification labels, and source attribution.

Add a company member to the job's hiring team. Use in workflow setup and ownership automation.

Advance an application to the next pipeline stage according to workflow order. No stage_id needed -- the system determines the next stage automatically. **Always pass `include=candidate,job`** when surfacing results in the widget — without it, the confirmation card can only show candidate/job IDs and cannot link to their backoffice pages.

Add tags to multiple candidates in one request (max 100). Returns per-item results with partial success support.

Create up to 100 scheduled messages in one request. Each item specifies its own candidate_id and message payload. Items are processed independently -- one failure does not stop others. Per-candidate RBAC is enforced for each item.

Get board publication states for multiple jobs in one request. Optimized for batch monitoring and management UIs.

Move multiple applications to a pipeline stage in one request. Returns per-item results with partial success support. Max 100 application IDs per request.

Activate board publication for multiple jobs in one request. Use for bulk job distribution workflows.

Reject multiple applications in one request with an optional rejection reason. Returns per-item results with partial success support. Max 100 application IDs per request.

Deactivate board publication for multiple jobs in one request. Use for bulk depublishing workflows.

Remove tags from multiple candidates in one request (max 100). Returns per-item results with partial success support.

Cancel all scheduled notification emails for a candidate. Already sent notifications are not affected. Returns success even if no scheduled notifications exist.

Create an application by linking an existing candidate to a job. Use for sourcing workflows and manual application ingestion. The candidate must already exist.

Create a new candidate profile. Optionally link to a job/stage and attach the candidate's resume as extracted text. Used for imports, inbound forms, and enrichment workflows. When the user provides an attached resume (PDF/DOCX/etc.), parse the file content yourself from the chat context — LLMs natively extract text from uploaded files — and pass the extracted text via resume_text. Do NOT attempt to inline binary file data: host function-call serializers truncate arguments above ~20KB.

Create a client company (partner tenant) — provisions its public career-site URL (slug) and public branding (logo, name). Typical entrypoint for multi-tenant onboarding.

Create a new email template with name, subject, and body. Subject and body support placeholders like {{first_name}}, {{job_title}}. To embed placeholders: 1) GET /template-placeholders to list them, 2) POST /template-placeholders/prepare to get the HTML tag, 3) insert the tag into the body.

Create a new application form, optionally attaching existing questions by ID.

Schedule a new interview for an application. Provide start/end times as Unix timestamps and a list of interviewer user IDs. Location is resolved to an existing record or created automatically.

Create a job with taxonomy, location, salary, and workflow configuration. Primary endpoint for programmatic job publishing. Required fields: status, title, description, location_city, location_country.

Register a webhook URL for job-related events. Core step for outbound integration setup. URL must be HTTPS. Returns a signing_secret once — store it to verify the x-hires-signature-v2 header on incoming deliveries.

Create a discussion note for a candidate. Supports visibility control (all or private) and @mentions with email notifications. **Always pass `include=candidate`** when surfacing results in the widget — without it, the confirmation card can only show the candidate ID and cannot link to their backoffice profile.

Create a nurture campaign with steps. Steps are executed sequentially; each step has a type (email, sms, voicemail, move_to_next_stage, assign_tag, assign_task) with type-specific fields. Optionally bind to a workflow stage.

Create a reusable question with optional answer options for dropdown types. Used by forms and questionnaires.

Create a company-scoped webhook subscription. Use for outbound company-level event integrations. Returns a signing_secret once — store it to verify the x-hires-signature-v2 header on incoming deliveries.

Permanently delete an application. This removes it from all list and view queries.

Permanently delete a candidate by ID or alias.

Delete (soft-delete) a company — takes its public career site offline. Use for lifecycle control in partner tenancy management.

Soft-delete an email template. Templates already used in automations will stop being available for new actions.

Delete an application form.

Delete a job. Use to align archived/removed positions across integrated platforms.

Delete a job webhook subscription by ID. Use for cleanup, rotation, and endpoint migration.

Cancel a scheduled message before it is processed by the mailbox scheduler.

Delete a note. Use for moderation policies and data cleanup operations.

Cancel a scheduled notification email before it is sent. Already sent messages cannot be canceled.

Delete (soft-delete) a nurture campaign. Active campaign executions will be stopped.

Delete a reusable question from the catalog. Use cautiously when deprecating question banks.

Delete a company-scoped webhook subscription by ID. Use for endpoint retirement and security rotation.

Disqualify a candidate from all active applications. Optionally provide rejection reason IDs. Returns affected application IDs.

Download an attachment (resume, candidate file, application file, mail attachment, call recording). Pass the absolute URL returned by another endpoint (e.g. `message.attachments[].url`, `cv.url`, `resume.url`) — it MUST belong to the configured 100Hires API host; other hosts are rejected to avoid leaking the Bearer token. Returns `{file_name, mime_type, size, data}` where `data` is base64-encoded bytes. Files larger than 25 MB are rejected up-front (Content-Length check / streaming abort) without being loaded into memory.

Get the structured AI score for an application, including per-criterion scores, justifications, and follow-up questions. Returns null score if the application has not been AI-scored.

Get full application details including stage, status, and rejection context. Recommended before mutating stage transitions.

Get billing/pricing capability flags for the current company. Use before invoking paid-only API behaviors.

Get full candidate data including application summaries by candidate ID or alias.

Get the primary resume for a candidate. Returns uuid, absolute download url (use Bearer auth), relative_time, file metadata, type. Use include='text_content' to also get the parsed plain-text content in a `text` field without downloading the file.

Get full details of a single public job by ID. Returns salary, education level, experience level, and other extended fields. Returns 404 for draft, archived, or internal jobs.

Get company profile and owner metadata. Use before updates or ownership-sensitive actions.

Get full details of a specific email template by ID, including subject and body content.

Get a filled evaluation form with all answers. Returns evaluator info, summary score, summary text, and individual question answers. Use for detailed review of evaluator feedback on a candidate application.

Get form details including all questions with their statuses.

Get full details of a specific interview by ID. Use `include` to embed related candidate, application, or job data.