---
name: "admin_list_people"
area: "admin"
title: "List the people on the account"
price: "free"
method: "POST"
url: "https://api.conecto.chat/v1/tools/admin_list_people"
mcp_server: "https://api.conecto.chat/mcp/admin"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/admin/admin_list_people"
---

# List the people on the account (`admin_list_people`)

Who besides the owner can open the account, with role, teams, areas and end of access, and the requests to join waiting.

Who besides the owner can open the account, with their role, teams, areas and when their access ends, and the requests to join waiting for a decision.

Price: Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads. A call that fails costs nothing.

## Use it when

Someone asks who has access, or before adding or removing a person.

## Say this to your agent

> Who can open our Conecto account, and is anyone waiting to join?

## Inputs

This tool takes no arguments: send `{}`.

## Example

Written for Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff.

MCP: call `admin_list_people` on the MCP server `https://api.conecto.chat/mcp/admin` with these arguments:

```json
{}
```

REST:

```bash
curl https://api.conecto.chat/v1/tools/admin_list_people \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "admin_list_people",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$0.00",
  "balance_usd": "$19.75",
  "result": {
    "owner": "henrik.voss@hansenvoss.example",
    "people": [
      {
        "email": "felix.wagner@hansenvoss.example",
        "name": "Felix Wagner",
        "role": "member",
        "areas": null,
        "access_until": null,
        "teams": [
          {
            "team": "Warehouse",
            "manager": false
          }
        ],
        "added_by": "key 1 (Pip)",
        "added_at": "2026-10-14T08:00:00+00:00"
      }
    ],
    "join_requests": [
      {
        "request_id": 4101,
        "email": "tom.okafor@hansenvoss.example",
        "name": "Tom Okafor",
        "status": "pending",
        "asked_at": "2026-10-14T08:00:00+00:00",
        "decided_at": null,
        "decided_by": null
      }
    ]
  }
}
```

`result`: owner, people (email, name, role, areas, access_until, teams with manager, added_by and added_at) and join_requests waiting for a decision.

## Errors

This tool has no errors of its own.

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [admin_overview](https://conecto.chat/tools/admin/admin_overview.md): The account page's Home in one read: balance, spending, limits, teams, people, keys, systems and rentals. Free up to 1,000,000 reads a month.
- [admin_save_setup](https://conecto.chat/tools/admin/admin_save_setup.md): Saves the answers to the first questions: the AI the business uses, the jobs to hand over, the systems it runs and its size. Free.
- [admin_save_person](https://conecto.chat/tools/admin/admin_save_person.md): Adds a person as a member or auditor, or changes their name, teams, areas or end of access. $0.001 a call.
- [admin_remove_person](https://conecto.chat/tools/admin/admin_remove_person.md): Takes a person's access away at once, with their own assistants. Free.
- [admin_list_domains](https://conecto.chat/tools/admin/admin_list_domains.md): The company's email domains on the account: proved or not, how people on them join, and the TXT record that proves each. Free up to 1,000,000 reads a month.
- [admin_save_domain](https://conecto.chat/tools/admin/admin_save_domain.md): Adds the company's email domain, proves it with a TXT record, and sets how people on it join. $0.001 a call.
- [admin_remove_domain](https://conecto.chat/tools/admin/admin_remove_domain.md): Takes a domain off the account; people who joined with it stay. Free.
- [admin_decide_join_request](https://conecto.chat/tools/admin/admin_decide_join_request.md): Approves someone who asked to join, as a member in their domain's team, or declines them. $0.001 a call.
- [admin_list_join_codes](https://conecto.chat/tools/admin/admin_list_join_codes.md): The one-time codes made for other bots to join, with their team, areas, expiry and the bot that used each. Free up to 1,000,000 reads a month.
- [admin_make_join_code](https://conecto.chat/tools/admin/admin_make_join_code.md): A one-time code another bot uses to join this account, for one team and its areas. $0.001 a call.
- [admin_revoke_join_code](https://conecto.chat/tools/admin/admin_revoke_join_code.md): Withdraws a join code no bot used yet. Free.
- [admin_list_bridges](https://conecto.chat/tools/admin/admin_list_bridges.md): The bridges inside the company's network: online or not, last check-in, version and the systems each serves. Free up to 1,000,000 reads a month.
- [admin_make_bridge](https://conecto.chat/tools/admin/admin_make_bridge.md): A new bridge for systems behind the company's firewall, with its token (shown once) and the steps for IT. $0.001 a call.
- [admin_revoke_bridge](https://conecto.chat/tools/admin/admin_revoke_bridge.md): Stops a bridge at once; calls waiting for it fail at no cost. Free.