Change an inbox
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
From your agent’s balance. A call that fails costs nothing.
An example
Save every attachment that arrives at invoices@ in our files. In spring we get about 30 bills a day there.
Your agent callsemail_update_inbox$0.001 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.
{
"inbox": "invoices@halverson-cycle-repair.useconecto.com",
"save_attachments": true,
"save_files_per_day": 50
}Use it when
An inbox's sender name changes, or the attachments it receives (bills, documents) should be filed.
What it does
Change an inbox's sender name, switch email-in on or off (save_attachments saves each attachment of mail received from now on to the file store, linked to its email), or raise or lower what email-in saves in 24 hours (save_files_per_day, save_mb_per_day). $0.001.
What comes back
The inbox, its sender name, opens_tickets, save_attachments and the daily caps on what it saves, as they now are. Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
inboxRequired | string | Up to 254 characters. |
display_name | string | Up to 120 characters. |
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. |
save_files_per_day | integer | Email-in: the most attachments saved in 24 hours. Default 100. 1 to 1,000. |
save_mb_per_day | integer | Email-in: the most MB of attachments saved in 24 hours. Default 250. 1 to 2,500. |
The call
Over MCP, call email_update_inbox on https://api.conecto.chat/mcp/email. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/email_update_inbox \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"inbox":"invoices@halverson-cycle-repair.useconecto.com","save_attachments":true,"save_files_per_day":50}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No active inbox of the business has that address. | Call email_list_inboxes and use one of its addresses. |
invalid_input400 | Nothing to change was given, or a daily cap is outside 1-1,000 files or 1-2,500 MB. | Send at least one field, within its limits. |
More Email tools
All 10 tools- Create an inbox
email_create_inboxA new email address for the business on its own subdomain, which sends and receives at once.$1.00 a call - List inboxes
email_list_inboxesThe business's inboxes, whether each opens tickets or saves attachments, and when each renews.Free* - Send an email
email_sendSends 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 to one person without attachments - List messages
email_list_messagesMessages in the business's inboxes, newest first: received, sent or both, for one inbox, one sender or since a time.Free* - Read a message
email_get_messageOne message in full: its text, HTML and attachment names.Free* - Read a thread
email_get_threadEvery message of one conversation, oldest first.Free* - Mark where a thread stands
email_update_threadMarks an email thread open, waiting, handled or archived, and sets its labels.$0.001 a call - Save an email's attachments
email_save_attachmentsSaves the files attached to one received email into the file store, each linked to the email.$0.001 per file saved
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md