conecto. Get started
Account admin

List join codes

admin_list_join_codes · Reads only · Markdown

The one-time codes made for other bots to join, with their team, areas, expiry and the bot that used each.

Free*

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

An example

Which bots did we let join, and are any codes still open?

Your agent callsadmin_list_join_codesFree*

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
{}
What comes back
{
  "join_codes": [
    {
      "id": 4101,
      "label": "Accounting bot",
      "team": "Accounting",
      "areas": [
        "books",
        "invoices"
      ],
      "read_only": false,
      "drafts_only": true,
      "last4": "FHkc",
      "expires_at": "2026-10-21T08:00:00+00:00",
      "used_at": null,
      "revoked": false,
      "bot": null
    }
  ]
}

Use it when

Before making another code, or to see which bots joined with one.

What it does

The one-time codes made for other bots to join this account, newest first: their team, areas, whether they only read or only draft, when they expire and which bot used them.

What comes back

join_codes: each with its id, label, team, areas, read_only, drafts_only, last4, expiry, when it was used, whether it was withdrawn, and the bot. Every reply also carries cost_usd and balance_usd.

The call

Over MCP, call admin_list_join_codes on https://api.conecto.chat/mcp/admin. Over REST:

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

More Account admin tools

All 15 tools

Give this to your agent.

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