Let colleagues join by email domain

admin_save_domain · Changes data · Markdown

Adds the company's email domain, proves it with a TXT record, and sets how people on it join.

$0.001 a call

From your agent’s balance. A call that fails costs nothing.

Let everyone with an @hansenvoss.example address ask to join, and put them in the Warehouse team.

Your agent callsadmin_save_domain$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.

With these arguments

{
  "domain": "hansenvoss.example",
  "verify": true,
  "joining": "request",
  "team": "Warehouse"
}

What comes back

{
  "domain": {
    "domain": "hansenvoss.example",
    "verified": true,
    "verified_at": "2026-10-14T08:00:00+00:00",
    "joining": "request",
    "team": "Warehouse",
    "areas": null,
    "dns_record": {
      "type": "TXT",
      "name": "@",
      "value": "conecto-verification=6ykvBp1em-09EK4SFTAYwHQaW9QV5fm8"
    },
    "added_at": "2026-10-14T08:00:00+00:00"
  },
  "added": true,
  "proved": true
}

Use it when

Colleagues should find the company's account when they sign in with their work address.

For one person you already know, use admin_save_person.

What it does

Add the company's email domain, prove it, and choose how people on it join. Added, it comes back with a TXT record for its DNS; once the record is up, verify: true proves it. joining: request lets people with an address there ask to join (an owner, admin or this agent approves with admin_decide_join_request); open lets them join right away as members, which only the owner turns on; off stops both. People who join get the domain's team and areas.

What comes back

domain: the domain with whether it is proved, how people join, their team and areas, and the TXT record to set; added; with verify, proved and what to fix if it is not. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`domain`Required	string	The part of the company's addresses after the @, like hansenvoss.example. 4 to 253 characters.
`verify`	boolean
`joining`	string	One of: off,request,open.
`team`	string	Up to 80 characters.
`areas`	array of strings

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/admin_save_domain \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"hansenvoss.example","verify":true,"joining":"request","team":"Warehouse"}'

When it refuses

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

Code	When	What to do
`invalid_input`400	The domain is not one, is a public email provider, or areas names no area.	Use the company's own domain, like hansenvoss.example.
`not_verified`409	The domain is not proved yet, so nobody can join with it.	Add the TXT record from dns_record, then call again with verify: true.
`not_found`404	No team has that name.	admin_overview lists the teams.
`scope_too_wide`409	The areas reach past the team's.	Pick areas inside the team's.
`owner_required`403	The key doesn't run the account, or joining right away was asked for.	Choose request instead, or hand the owner a link: account_owner_link with page settings.
`limit_reached`409	The account has 10 domains.	Remove one first.
`rate_limited`429	Twenty DNS checks an hour at most.	Wait; DNS changes can take an hour to show.

More Account admin tools

All 15 tools

Give this to your agent.

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

Let colleagues join by email domain

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Account admin tools

Give this to your agent.