conecto. Get started
HR

List people

hr_list_people · Reads only · Markdown

People by last name, everyone who hasn't left by default, filtered by status, department, location, manager, type or words.

Free*

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

An example

Who works in the warehouse, and who do they report to?

Your agent callshr_list_peopleFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "department": "Warehouse"
}
What comes back
{
  "people": [
    {
      "person_id": 4103,
      "name": "Jonas Becker",
      "first_name": "Jonas",
      "last_name": "Becker",
      "preferred_name": null,
      "work_email": "jonas.becker@hansenvoss.example",
      "job_title": "Warehouse operative",
      "department": "Warehouse",
      "location": "Hamburg",
      "manager": {
        "person_id": 4101,
        "name": "Lena Brandt"
      },
      "employment_type": "full_time",
      "start_date": "2022-08-01",
      "probation_end": null,
      "end_date": null,
      "status": "active"
    },
    {
      "person_id": 4105,
      "name": "Felix Wagner",
      "first_name": "Felix",
      "last_name": "Wagner",
      "preferred_name": null,
      "work_email": "felix.wagner@hansenvoss.example",
      "job_title": "Warehouse operative",
      "department": "Warehouse",
      "location": "Hamburg",
      "manager": {
        "person_id": 4101,
        "name": "Lena Brandt"
      },
      "employment_type": "full_time",
      "start_date": "2026-11-02",
      "probation_end": "2027-04-30",
      "end_date": null,
      "status": "active"
    }
  ],
  "total": 2
}

Use it when

To find someone's person_id, or see a team.

What it does

People on the account by last name; by default everyone who hasn't left (current, future joiners included). Filter by status (active, on_leave, left, all), department, location, manager (their direct reports), employment type, or search words across names, emails and job title (every word must match).

What comes back

people: each with their person_id, names, emails, job, department, location, manager, type, status and dates; and the total. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
statusstringOne of: current,active,on_leave,left,all. Default: current.
departmentstringUp to 120 characters.
locationstringUp to 120 characters.
managerinteger or stringThe person_id, or their work email. 1 to 254 characters, at least 1.
employment_typestringOne of: full_time,part_time,contractor,intern.
searchstringUp to 100 characters.
limitinteger1 to 500. Default: 100.
offsetintegerAt least 0. Default: 0.

The call

Over MCP, call hr_list_people on https://api.conecto.chat/mcp/hr. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hr_list_people \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"department":"Warehouse"}'

When it refuses

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

CodeWhenWhat to do
not_found404No person of the business has that person_id or work email.Find them with hr_list_people.

More HR tools

All 23 tools

Give this to your agent.

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