Email an applicant
Emails an applicant in the business's name; replies go to the careers page's reply-to address.
$0.02 a call
From your agent’s balance. A call that fails costs nothing.
An example
Tell Jan Kowalski kindly that we went with someone else for the mechanic job.
Your agent callshiring_email_applicant$0.02 a call
The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.
{
"applicant_id": 4102,
"subject": "Your application for the mechanic job",
"text": "Dear Jan,\n\nthank you for applying to Halverson Cycle & Repair. We have chosen another candidate this time, and we would be glad to hear from you again.\n\nLuis Ortega"
}Use it when
A candidate should hear from the business: a next step, a question, or a kind no.
- For an interview invitation with a booking link, use
hiring_invite_to_interview.
What it does
Email an applicant in the business's name (replies go to the careers page's reply_to): an interview invitation with a booking link, a next step, or a kind no.
What comes back
sent_to: the address the email went to. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
applicant_idRequired | integer | At least 1. |
subjectRequired | string | 1 to 200 characters. |
textRequired | string | 1 to 10,000 characters. |
by_person | boolean | true when a person at the business wrote it. Otherwise a last line says the business's AI assistant wrote it (EU AI Act Art. 50). Default: false. |
The call
Over MCP, call hiring_email_applicant on https://api.conecto.chat/mcp/hiring. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/hiring_email_applicant \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"applicant_id":4102,"subject":"Your application for the mechanic job","text":"Dear Jan,\n\nthank you for applying to Halverson Cycle & Repair. We have chosen another candidate this time, and we would be glad to hear from you again.\n\nLuis Ortega"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No applicant of the business has that applicant_id. | Find them with hiring_list_applicants. |
payment_required402 | The application came in while the balance could not pay its fee, so it is held. | Top up; the application opens once its fee is paid. |
send_failed502 | The email could not be sent; nothing was charged. | Call again in a moment. |
More Hiring tools
All 25 tools- Set up the careers page
hiring_setup_careersSets up the careers page at cncto.co/j/<name>: its name, intro, website, reply-to address and who hears about applications.$0.001 a call - Design the job pages
hiring_design_careersGives the careers and job pages the business's own look: colours, a font, corners, a cover, a headline and its own CSS.$0.001 a call - Post a job
hiring_create_jobPosts a job with its own page and application form on the careers page.$0.01 a call - Change a job
hiring_update_jobChanges a job's details, its criteria and filter, or opens or closes it.$0.01 a call - List jobs
hiring_list_jobsThe business's jobs with their status, page and applicants per stage.Free* - List applicants
hiring_list_applicantsApplicants, newest or best match first: for one job or all, by stage, screening, risk, name or email, or the ones kept as spam.Free* - Read an application
hiring_get_applicantOne application in full: answers, résumé link, screening and match score, the checks on who sent it, notes and history.Free* - Applications to screen
hiring_screen_queueThe next applications nobody has screened, with the job's criteria and the résumé as text, blind by default.Free*
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md