Hiring

Applications to screen

hiring_screen_queue · Reads only · Markdown

The next applications nobody has screened, with the job's criteria and the résumé as text, blind by default.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Go through the new bike mechanic applications against our criteria.

Your agent callshiring_screen_queueFree*

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.

With these arguments
{
  "job": "bike-mechanic",
  "limit": 5
}
What comes back
{
  "jobs": [
    {
      "job": "bike-mechanic",
      "title": "Bike mechanic",
      "description": "We build, tune and repair city, gravel and cargo bikes in our Portland workshop. You work the stand with two other mechanics: tune-ups, brake bleeds, wheel builds and e-bike checks.\n\n**You have** two years or more in a bike shop, and your own basic tools.\n\n**We offer** paid time off, health insurance and a staff discount on bikes and parts.",
      "criteria": [
        {
          "id": "c1",
          "text": "Two years as a mechanic in a bike shop",
          "required": true,
          "weight": 3
        },
        {
          "id": "c2",
          "text": "Has built wheels",
          "required": false,
          "weight": 3
        }
      ],
      "filter": null
    }
  ],
  "applications": [
    {
      "applicant_id": 4101,
      "job": "bike-mechanic",
      "applied_at": "2026-10-14T08:00:00+00:00",
      "stage": "Applied",
      "answers": [
        {
          "question": "How many years have you worked as a bike mechanic?",
          "answer": 6
        },
        {
          "question": "Can you lift 50 lb?",
          "answer": true
        }
      ],
      "flags": [],
      "cover_letter": "I have worked in bike shops for six years, the last two also building wheels for a cyclocross team.",
      "resume": {
        "text": "[name] [name]\n\nBike mechanic, 6 years\n\nTune-ups, brake bleeds, wheel builds",
        "truncated": false,
        "note": null
      }
    },
    {
      "applicant_id": 4102,
      "job": "bike-mechanic",
      "applied_at": "2026-10-14T08:00:00+00:00",
      "stage": "Applied",
      "answers": [
        {
          "question": "How many years have you worked as a bike mechanic?",
          "answer": 2
        },
        {
          "question": "Can you lift 50 lb?",
          "answer": true
        }
      ],
      "flags": [],
      "cover_letter": "I fix my friends' bikes and want to learn in a real shop.",
      "resume": {
        "text": "[name] [name]\n\nBike mechanic, 2 years\n\nTune-ups, brake bleeds, wheel builds",
        "truncated": false,
        "note": null
      }
    }
  ],
  "remaining": 0
}

Use it when

New applications wait for a first review; save each with hiring_record_screening.

What it does

The next applications nobody has screened yet, oldest first, with what a review needs: the job, its criteria and filter, the answers and flags, the cover letter and the résumé as text. Blind by default: name, email, phone and links are left out and replaced in the text, so the review rests on what they did. Review each one yourself and save it with hiring_record_screening; Conecto never rejects anyone. To screen each application as it arrives, send hiring.application_received to your webhook with notify_subscribe, or read account_events.

What comes back

jobs: the jobs with their criteria; applications: each with its applicant_id, answers, flags, cover letter and résumé text (name and contacts left out when blind); and how many more wait. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
jobstringThe job (its slug from hiring_list_jobs). 1 to 80 characters.
limitinteger1 to 10. Default: 5.
blindbooleanDefault: true.

The call

Over MCP, call hiring_screen_queue on https://api.conecto.chat/mcp/hiring. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hiring_screen_queue \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job":"bike-mechanic","limit":5}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_found404No job of the business has that slug.Call hiring_list_jobs and use one of its slugs.
ai_review_off409Candidates were not told that AI may help review applications.Run hiring_setup_careers with ai_review: true first.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md