Create an inbox

email_create_inbox · Changes data · Markdown

A new email address for the business on its own subdomain, which sends and receives at once.

$1.00 a call

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

Set up support@ for customer questions, signed Halverson Support, and make every email there a ticket.

Your agent callsemail_create_inbox$1.00 a call

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments

{
  "local_part": "support",
  "display_name": "Halverson Support",
  "open_tickets": true
}

What comes back

{
  "inbox": "support@halverson-cycle-repair.useconecto.com",
  "display_name": "Halverson Support",
  "opens_tickets": true,
  "save_attachments": false,
  "rent": {
    "rental_id": 4101,
    "kind": "inbox",
    "label": "Inbox support@halverson-cycle-repair.useconecto.com",
    "status": "active",
    "monthly_usd": "$1.00",
    "renews_at": "2026-11-14T08:00:00+00:00",
    "grace_until": null
  }
}

Use it when

The business needs an address: support@ for customers, invoices@ for supplier bills, hello@ for the website.

For turning an inbox that exists into a support inbox, use ticket_connect_inbox.

What it does

A new email address for the business on its own subdomain, e.g. support@acme.useconecto.com. It can send and receive at once. With open_tickets=true it is a support inbox: every new email to it opens a help desk ticket (see ticket_connect_inbox). With save_attachments=true, attachments of mail it receives go to the file store (email-in, e.g. invoices@ for supplier bills). Rented at $1.00 a month, renewed from the balance; the first month is this call.

What comes back

The inbox address, sender name, whether it opens tickets and saves attachments, and the rental that renews it each month. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`local_part`Required	string	The part before the @, e.g. "support" or "sales". 1 to 40 characters.
`display_name`	string	Shown as the sender name. Up to 120 characters.
`open_tickets`	boolean	New mail opens a help desk ticket; ticket replies go out from here. Default: false.
`save_attachments`	boolean	Email-in: save each attachment of mail received here to the file store, linked to its email (files.added tells you, with its text). The store's space counts; when it is full an attachment is skipped and the email says so. Anyone can write to an inbox, so it saves at most save_files_per_day files and save_mb_per_day MB in 24 hours (100 and 250 by default); past that the email still arrives with its attachments listed as not saved. Default: false.

The call

Over MCP, call email_create_inbox on https://api.conecto.chat/mcp/email. Over REST:

Terminal

curl -X POST https://api.conecto.chat/v1/tools/email_create_inbox \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"local_part":"support","display_name":"Halverson Support","open_tickets":true}'

When it refuses

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

Code	When	What to do
`invalid_input`400	local_part has characters an address cannot have.	Use a-z, 0-9, dots, dashes and underscores, starting and ending with a letter or digit.
`conflict`409	The address exists already, or is not available.	Pick another local_part.

More Email tools

All 10 tools

Give this to your agent.

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

Create an inbox

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Email tools

Give this to your agent.