Add or change a person
Adds a person as a member or auditor, or changes their name, teams, areas or end of access.
$0.001 a call
From your agent’s balance. A call that fails costs nothing.
An example
Add Felix Wagner from the warehouse, felix.wagner@hansenvoss.example, to the Warehouse team.
Your agent callsadmin_save_person$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.
{
"email": "felix.wagner@hansenvoss.example",
"name": "Felix Wagner",
"teams": [
"Warehouse"
]
}Use it when
Someone new should connect their own assistant, or an advisor needs to read for a while.
- For letting everyone at the company ask to join, use
admin_save_domain.
What it does
Add someone to the account as a member (their own assistant works in their teams) or an auditor (reads everything, changes nothing), or change one: their name, teams, areas and the day their access ends. They are told by email when added. Making someone an owner, admin or billing person is the owner's.
What comes back
person: their email, name, role, areas, access_until and teams; added: whether they are new, in which case they got an email. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
emailRequired | string | 3 to 254 characters. |
name | string | Up to 120 characters. |
role | string | One of: member,auditor,admin,billing,owner. Default: member. |
teams | array of strings | Their teams, replacing the ones they are in. Up to 20 items. |
areas | array of strings | For an account without teams: the areas their assistant works in. |
access_until | string | The last day of their access, like 2027-03-31. Up to 10 characters. |
The call
Over MCP, call admin_save_person on https://api.conecto.chat/mcp/admin. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/admin_save_person \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"felix.wagner@hansenvoss.example","name":"Felix Wagner","teams":["Warehouse"]}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
invalid_input400 | The address, an area or access_until is not valid, or it is the owner's address. | Fix the value the message names. |
not_found404 | No team has that name. | admin_overview lists the teams. |
owner_required403 | The key doesn't run the account, or the role asked for is above member. | Use a key of the company-wide team, or hand the owner a link: account_owner_link with page people. |
limit_reached409 | The account has 100 people besides the owner. | Remove someone first. |
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* - 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 - Approve or decline a request to join
admin_decide_join_requestApproves someone who asked to join, as a member in their domain's team, or declines them.$0.001 a call
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md