---
name: "email_create_inbox"
area: "email"
title: "Create an inbox"
price: "$1.00"
method: "POST"
url: "https://api.conecto.chat/v1/tools/email_create_inbox"
mcp_server: "https://api.conecto.chat/mcp/email"
auth: "Authorization: Bearer <conecto_sk_ key>"
docs_url: "https://conecto.chat/tools/email/email_create_inbox"
---

# Create an inbox (`email_create_inbox`)

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

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.

Price: $1.00 a call. A call that fails costs nothing.

## 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](https://conecto.chat/tools/helpdesk/ticket_connect_inbox.md).

## Say this to your agent

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

## Inputs

| Name | Type | Required | Description | Allowed values | Default |
|---|---|---|---|---|---|
| `local_part` | string | yes | The part before the @, e.g. "support" or "sales". 1 to 40 characters. |  |  |
| `display_name` | string | no | Shown as the sender name. Up to 120 characters. |  |  |
| `open_tickets` | boolean | no | New mail opens a help desk ticket; ticket replies go out from here. |  | `false` |
| `save_attachments` | boolean | no | 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. |  | `false` |

## Example

Written for Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon.

MCP: call `email_create_inbox` on the MCP server `https://api.conecto.chat/mcp/email` with these arguments:

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

REST:

```bash
curl 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}'
```

## Response

```json
{
  "call_id": "5f0c8a2e-3b7d-4c1e-9a64-2d8e1f7b0c93",
  "tool": "email_create_inbox",
  "status": "succeeded",
  "replayed": false,
  "cost_usd": "$1.00",
  "balance_usd": "$19.75",
  "result": {
    "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
    }
  }
}
```

`result`: The inbox address, sender name, whether it opens tickets and saves attachments, and the rental that renews it each month.

## Errors

| Code | Status | When | Fix |
|---|---|---|---|
| `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. |

The refusals every tool can give (401 key, 402 balance, 429 limits) are on the errors page: https://conecto.chat/docs/errors.md

## Related

- [email_list_inboxes](https://conecto.chat/tools/email/email_list_inboxes.md): The business's inboxes, whether each opens tickets or saves attachments, and when each renews. Free up to 1,000,000 reads a month.
- [email_update_inbox](https://conecto.chat/tools/email/email_update_inbox.md): Changes an inbox's sender name, switches saving its attachments to the file store on or off, or changes how much it saves a day. $0.001 a call.
- [email_send](https://conecto.chat/tools/email/email_send.md): Sends an email from one of the business's inboxes, with files from the store attached, or answers a received message in its thread. $0.001 per recipient, plus $0.001 per started MB of attachments for each recipient ($0.001 to one person without attachments), up to $0.52.
- [email_list_messages](https://conecto.chat/tools/email/email_list_messages.md): Messages in the business's inboxes, newest first: received, sent or both, for one inbox, one sender or since a time. Free up to 1,000,000 reads a month.
- [email_get_message](https://conecto.chat/tools/email/email_get_message.md): One message in full: its text, HTML and attachment names. Free up to 1,000,000 reads a month.
- [email_get_thread](https://conecto.chat/tools/email/email_get_thread.md): Every message of one conversation, oldest first. Free up to 1,000,000 reads a month.
- [email_update_thread](https://conecto.chat/tools/email/email_update_thread.md): Marks an email thread open, waiting, handled or archived, and sets its labels. $0.001 a call.
- [email_save_attachments](https://conecto.chat/tools/email/email_save_attachments.md): Saves the files attached to one received email into the file store, each linked to the email. $0.001 per file saved.
- [email_release_inbox](https://conecto.chat/tools/email/email_release_inbox.md): Stops renting an inbox: mail sent to it later bounces, and its stored messages stay readable. Free.