Make a join code for another bot
A one-time code another bot uses to join this account, for one team and its areas.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Our accountant's bot should draft invoices and bookings for us. Let it in, drafts only.
Your agent callsadmin_make_join_code$0.001 a call
The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.
{
"label": "Accounting bot",
"team": "Accounting",
"areas": [
"books",
"invoices"
],
"drafts_only": true
}Use it when
Another agent (a department's, or a colleague's) should work on this account, not alone.
What it does
A one-time code another bot uses to join this account instead of signing up alone: the key it gets works for the code's team, within its areas, and only reads or only drafts when the code says so. Shown once; it works for days (1 to 30, 7 by default). Hand the bot the sentence in give_your_bot.
What comes back
join_code with its code (shown once) and give_your_bot: the sentence to hand the other bot. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
label | string | What the bot is for. Up to 80 characters. |
team | string | Up to 80 characters. |
areas | array of strings | |
read_only | boolean | |
drafts_only | boolean | |
days | integer | 1 to 30. Default: 7. |
The call
Over MCP, call admin_make_join_code on https://api.conecto.chat/mcp/admin. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/admin_make_join_code \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"label":"Accounting bot","team":"Accounting","areas":["books","invoices"],"drafts_only":true}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | areas names no area. | Use area names, or [] for the team's. |
not_found404 | No team has that name. | admin_overview lists the teams. |
scope_too_wide409 | The areas reach past the team's. | Pick areas inside the team's. |
owner_required403 | The key is not one that runs the account: it works for one team, has limits, or is a member's assistant. | Use a key of the company-wide team without limits, or ask the owner (account_owner_link). |
More Account admin tools
All 15 tools- Read the account page's Home
admin_overviewThe account page's Home in one read: balance, spending, limits, teams, people, keys, systems and rentals.Free* - Answer the first questions
admin_save_setupSaves the answers to the first questions: the AI the business uses, the jobs to hand over, the systems it runs and its size.Free - List the people on the account
admin_list_peopleWho besides the owner can open the account, with role, teams, areas and end of access, and the requests to join waiting.Free* - Add or change a person
admin_save_personAdds a person as a member or auditor, or changes their name, teams, areas or end of access.$0.001 a call - Remove a person
admin_remove_personTakes a person's access away at once, with their own assistants.Free - List the email domains
admin_list_domainsThe company's email domains on the account: proved or not, how people on them join, and the TXT record that proves each.Free* - Let colleagues join by email domain
admin_save_domainAdds the company's email domain, proves it with a TXT record, and sets how people on it join.$0.001 a call - Remove an email domain
admin_remove_domainTakes a domain off the account; people who joined with it stay.Free
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md