hires_send_candidate_message
Schedule an email message to a candidate. If scheduled_at is omitted, the message is scheduled for 15 minutes after creation.
This record as markdown: /tools/com-100hires-100hires/hires-send-candidate-message.md
What hires_send_candidate_message does on 100Hires - AI ATS & Recruitment Software
AI agents use hires_send_candidate_message 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 |
|---|---|---|---|
cc | array | — | Carbon-copy recipient email addresses. |
id | string | number | Yes | Candidate ID (integer) or alias (string). |
to | array | Yes | Primary recipient email addresses. |
bcc | array | — | Blind carbon-copy recipient email addresses. |
body | string | Yes | Email body as HTML. |
subject | string | Yes | Email subject line. |
scheduled_at | number | null | — | Unix timestamp (seconds) for when to send. Defaults to 15 minutes after creation. |
application_id | number | null | — | Optional application ID to link this message to. |
from_account_id | number | null | — | Sending mail account ID. If omitted, uses the API key owner's default mail account. |
reply_to_email_id | number | null | — | Optional mailbox message ID to reply to. |
send_in_new_thread | boolean | — | Send as a new email thread instead of replying in an existing one. |
Parameters from the server's own tool schema.
Why hires_send_candidate_message is rated Medium
This tool creates/schedules new communication artifacts (emails) in the system, which is a reversible write operation. While it sends outbound messages, the action itself is creating data records and scheduling them rather than executing arbitrary code or causing financial harm.
From the tool's definition Tool creates and schedules email messages to candidates ('Schedule an email message to a candidate'). This is a write operation that modifies system state by creating new message records.
Risk signalsAccepts raw HTML/template content (body) · High parameter count (11 properties)
Attacks that exploit this kind of access
The rule that runs hires_send_candidate_message 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_send_candidate_message, this is the rule to start with:
hires_send_candidate_message 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_send_candidate_message call is checked against it from then on.
Questions about hires_send_candidate_message
Schedule an email message to a candidate. If scheduled_at is omitted, the message is scheduled for 15 minutes after creation. 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_send_candidate_message accepts 11 parameters: cc, id, to, bcc, body, subject, scheduled_at, application_id, from_account_id, reply_to_email_id, send_in_new_thread. Required: id, to, body, subject. 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_send_candidate_message: 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_send_candidate_message 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_send_candidate_message 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_send_candidate_message. 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_send_candidate_message 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