Homerun logo Homerun automation · runs daily

Disqualify unqualified Homerun candidates in bulk

Every new job post fills the Application stage with people who clearly do not fit, and each one needs a profile opened, a reason picked and a notification choice made before the list gets short enough to review.

Cotlet does it in your own Homerun account with list_candidates, get_candidate, list_disqualification_reasons and disqualify_candidate, called by your AI agent, an n8n workflow or a script.

Sign up free All Homerun tools

Hosted · nothing to install or maintain

Can Homerun do this on its own?

Homerun can disqualify by hand or by bulk selection in the app, and knockout questions can disqualify automatically (checked 22 Oct 2026). Its Public API returns a candidate's disqualification reason, but the docs list no action that sets one. Nothing in Homerun reads the free-text answers and decides.

How you do it in Homerun today

  1. Open Jobs in the sidebar, pick the job and choose Candidates in the top menu bar, then open a candidate to read their profile and application answers.
  2. Click the Disqualify icon (a forbidden sign) in the profile task bar and choose a reason, such as Too junior or No relevant experience.
  3. Decide how to notify the candidate: by email with a template, by creating a to-do, or with Do not notify, then click Send, Create or Done.
  4. For many candidates, switch to the list view, tick the checkboxes and click the Disqualify icon in the bottom task bar, which applies one reason to all of them.
  5. Disqualified candidates leave the list of all candidates for the job and show only in Table view, so a wrong click is easy to miss.

How to disqualify unqualified Homerun candidates in bulk

Prompt

Go through the candidates in the Application stage of Customer Success Manager. Disqualify the ones whose answers show no relevant experience, without emailing them, and leave every unclear one for me with a one-line reason.
  1. 01

    Read the stage

    list_candidates runs for the job with stage set to Application and returns each candidate with their stage, origin and tags. Candidates already disqualified are left out, so a repeat run never judges the same person twice.

  2. 02

    Read each application

    get_candidate brings the contact details, the answers to the application form, the ratings and the notes. The decision rests on those answers and not on the name or the CV file name.

  3. 03

    Match your criteria

    Each candidate is compared with the rule in your prompt. The agent quotes the answer it relied on, so you can see why each person was picked.

  4. 04

    Pick a real reason

    list_disqualification_reasons runs once, and the closest of your reasons is used. A reason your account does not have is reported, never made up, because adding reasons is an account setting you keep.

  5. 05

    Disqualify quietly

    disqualify_candidate runs with notify set to none unless you asked for an email. Each call waits for your OK until you switch confirmation off for it, because an email to a candidate cannot be taken back.

  6. 06

    Leave the unclear

    Candidates whose answers are empty, mixed or in another language stay in the stage with a one-line note for you, so the shortlist you review is already clean.

What you get back

Example data

Candidates in Application: 22
Disqualified 13, no email (reason: No relevant experience)
Left for you 9:
- Dana Whitfield: answered 2 of 5 questions
- Omar Haddad: experience in a neighbouring field
Already disqualified by a colleague: 0

Other ways to ask

  • Every morning, disqualify candidates who answered No to the work permit question and tell them by email with my standard template.
  • Show me which candidates in Application I would disqualify, as a table with the reason, and change nothing.
  • Disqualify everyone who asks for a salary above the range in the job post, reason Salary expectation too high.
  • Find candidates I disqualified last week for Perhaps in the future and list them so I can reconsider.

What Homerun allows, and what to know first

  • Homerun ships these reasons: Too junior, Too senior, No relevant experience, Position was filled, Position was put on hold, Perhaps in the future, Salary expectation too high, Accepted another offer, Stopped responding or didn't show, Not willing to relocate.
  • The disqualification reason is not shared with the candidate, so a rejection email says only what you write in it.
  • A disqualified candidate can be re-qualified, which puts them back in the stage they were in before.
  • Disqualified candidates are hidden from the Kanban view and visible in Table view only.
  • Homerun can also disqualify automatically with knockout questions on the application form; this job covers the answers such a rule cannot judge.

disqualify_candidate asks for your OK by default. To run it daily without you, switch confirmation off for that tool in your dashboard.

Sources: Homerun Help: How to disqualify candidates · Homerun Help: How to add a new disqualification reason · Homerun Help: How to re-qualify candidates · Homerun Public API documentation

Call disqualify_candidate from a script

curl

curl -X POST https://cotlet.dev/api/v1/homerun/jobs/job_3b7e91/candidates/ap_N4pQ8sT2vX6zB1cD3eF5/disqualify \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reason":"No relevant experience","notify":"none"}'

Example response

{
  "candidate_id": "ap_N4pQ8sT2vX6zB1cD3eF5",
  "status": "disqualified",
  "reason": "No relevant experience",
  "notified": "none",
  "stage_before": "Application"
}

MCP: add https://cotlet.dev/mcp/v1 with the same key; the call is homerun_write → disqualify_candidate. Example data.

Schedule it in n8n, Make, Zapier or cron

Homerun tools this automation uses

Cotlet Homerun tools used to disqualify unqualified Homerun candidates in bulk
Tool Parameters
list_candidates job_id, stage, tag, status
get_candidate job_id, candidate_id
list_disqualification_reasons none
disqualify_candidate job_id, candidate_id, reason, notify, email_body
All 14 Homerun tools with descriptions

Frequently asked questions

Will the candidate be told why they were disqualified?

No. Homerun does not share the disqualification reason with the candidate. They hear only from an email, and only when you choose to send one.

Is it safe to connect Homerun to Cotlet?

Yes. You sign in to Homerun yourself, in your own Cloud Browser in the EU, and we never save your password. Your agents only get Homerun once you enable it, every background request is listed, and the browser profile is stored encrypted with AES-256-GCM, the cipher 1Password uses for its vaults. The AI model never sees a login, posts and messages wait for your OK, and Disable for agents cuts access in one click. Independent scanners grade cotlet.dev A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory; live results are on https://cotlet.dev/security.

Give your agent access to Homerun.

Free 7-day trial with 2,000 credits, no card needed. Cotlet is independent and not affiliated with Homerun.

Sign up free