conecto. Get started
Hiring

Note or rate an applicant

hiring_note · Changes data · Markdown

Adds a note to an applicant, rates them 1 to 5, or both.

$0.01 a call

From your agent’s balance. A call that fails costs nothing.

An example

Note on Maria: great portfolio, ask her about Saturday work. I'd give her a 4.

Your agent callshiring_note$0.01 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.

With these arguments
{
  "applicant_id": 4101,
  "note": "Great portfolio. Ask about Saturday work at the interview.",
  "rating": 4
}
What comes back
{
  "applicant": {
    "applicant_id": 4101,
    "job": "bike-mechanic",
    "name": "Maria Santos",
    "email": "maria.santos@example.com",
    "phone": "+1 503 555 0130",
    "stage": "Applied",
    "rating": 4,
    "source": "careers",
    "applied_at": "2026-10-14T08:00:00+00:00",
    "updated_at": "2026-10-14T08:00:00+00:00",
    "has_resume": true,
    "flags": [],
    "screened": null,
    "stage_since": "2026-10-14T08:00:00+00:00",
    "stages_reached": [
      "Applied"
    ],
    "assessments": [],
    "interview": null,
    "next_step": {
      "step": "review",
      "label": "To review",
      "waiting_on": "you",
      "at": "2026-10-14T08:00:00+00:00",
      "overdue": false
    },
    "match_score": null,
    "screening_summary": null,
    "passed_filter_at": null,
    "risk": "high",
    "signals": {
      "risk": "high",
      "high": [
        {
          "code": "shared_phone",
          "applicant_ids": [
            2
          ],
          "text": "The same phone number is on 1 other application under another email address."
        }
      ],
      "minor": [],
      "authentic": [
        {
          "code": "name_in_email",
          "text": "Their name is in their email address."
        }
      ],
      "checked_at": "2026-10-14T08:00:00+00:00"
    },
    "spam": false,
    "links": [],
    "cover_letter": "I have worked in bike shops for six years, the last two also building wheels for a cyclocross team.",
    "answers": [
      {
        "question": "How many years have you worked as a bike mechanic?",
        "answer": 6
      },
      {
        "question": "Can you lift 50 lb?",
        "answer": true
      }
    ],
    "screening": null,
    "notes": [
      {
        "at": "2026-10-14T08:00:00+00:00",
        "by": "Pip",
        "body": "Great portfolio. Ask about Saturday work at the interview."
      }
    ],
    "history": [
      {
        "at": "2026-10-14T08:00:00+00:00",
        "change": "Applied"
      }
    ],
    "interview_invite": null,
    "resume": {
      "file_id": "742e9628-c4ca-493d-b586-b59b2fc7ecec",
      "name": "Résumé Maria Santos.pdf",
      "content_type": "application/pdf",
      "size": "1.1 KB",
      "size_bytes": 1153,
      "sha256": "6b65acac1ceea7ed3492428300b2b14437c63d6d3c622e96f0d76366e03b0fb9",
      "created_at": "2026-10-14T08:00:00+00:00",
      "download_url": "https://cncto.co/d/742e9628-c4ca-493d-b586-b59b2fc7ecec?t=eyJmIjoiNzQyZTk2MjgtYzRjYS00OTNkLWI1ODYtYjU5YjJmYzdlY2VjIiwiZXhwIjoxNzkyNTAyMjA4fQ:1xInEO:-gWMh27XF2Mqr4mC9OQvmWi7PvxH7Eh1i5VxnXANAaI",
      "link_expires_in_hours": 24
    }
  }
}

Use it when

Something about a candidate should be remembered, or they get a score.

What it does

Add a note to an applicant, and/or rate them 1 to 5.

What comes back

applicant: the application with the note and rating. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
applicant_idRequiredintegerAt least 1.
notestring1 to 5,000 characters.
ratinginteger1 to 5.

The call

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

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hiring_note \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"applicant_id":4101,"note":"Great portfolio. Ask about Saturday work at the interview.","rating":4}'

When it refuses

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

CodeWhenWhat to do
not_found404No applicant of the business has that applicant_id.Find them with hiring_list_applicants.
payment_required402The 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.

More Hiring tools

All 25 tools

Give this to your agent.

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