hires_create_candidate
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 na...
This record as markdown: /tools/com-100hires-100hires/hires-create-candidate.md
What hires_create_candidate does on 100Hires - AI ATS & Recruitment Software
AI agents use hires_create_candidate to create or update resources in 100Hires - AI ATS & Recruitment Software, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your 100Hires - AI ATS & Recruitment Software environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
city | string | — | Candidate city for location/timezone resolution. |
email | string | — | Candidate email address. Used for deduplication. |
phone | string | — | Candidate phone number. |
state | string | — | Candidate state or region. |
job_id | number | — | Job ID to create an application for this candidate. |
country | string | — | Candidate country name or ISO code. |
profile | object | — | Key-value map of profile field answers. Keys can be question text or question_id. Example: {"Current job title": "Senior Engineer"}. |
stage_id | number | — | Pipeline stage ID for the initial application. Requires job_id. |
timezone | string | — | IANA timezone (e.g. 'America/Los_Angeles'). Auto-resolved from city/country if omitted. |
last_name | string | — | Candidate last name. |
company_id | number | — | Target company ID. Required only when the API key has access to multiple companies. |
first_name | string | — | Candidate first name. |
Parameters from the server's own tool schema.
Why hires_create_candidate is rated Medium
This tool creates new candidate records in the recruitment system, which is a reversible write operation. It does not execute arbitrary code, delete data, move money, or have destructive side effects.
From the tool's definition Tool description explicitly states 'Create a new candidate profile' and mentions 'imports, inbound forms, and enrichment workflows' which are data creation operations. The tool creates new records in the ATS system.
Risk signalsHigh parameter count (13 properties)
Attacks that exploit this kind of access
The rule that runs hires_create_candidate safely
PolicyLayer is an MCP gateway: it sits between your AI agents and 100Hires - AI ATS & Recruitment Software, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For hires_create_candidate, this is the rule to start with:
hires_create_candidate stays usable, but capped: an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect 100Hires - AI ATS & Recruitment Software, apply this rule, and every hires_create_candidate call is checked against it from then on.
Questions about hires_create_candidate
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. It is categorised as a Write tool in the 100Hires - AI ATS & Recruitment Software MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
hires_create_candidate accepts 12 parameters: city, email, phone, state, job_id, country, profile, stage_id, timezone, last_name, company_id, first_name. The full parameter table on this page comes from the server's own tool schema.
Register the 100Hires - AI ATS & Recruitment Software MCP server in PolicyLayer and add a rule for hires_create_candidate: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches 100Hires - AI ATS & Recruitment Software. Nothing to install.
hires_create_candidate is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the hires_create_candidate rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for hires_create_candidate. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
hires_create_candidate is provided by the 100Hires - AI ATS & Recruitment Software MCP server (https://mcp.100hires.com/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on 100Hires - AI ATS & Recruitment Software, and thousands of servers like it.
Across the catalogue