Save an email's attachments
Saves the files attached to one received email into the file store, each linked to the email.
$0.001 per file saved
From your agent’s balance. A call that fails costs nothing.
An example
Paul Hoffmann sent photos of the scratch on his frame. Keep them so the workshop can see them.
Your agent callsemail_save_attachments$0.001 per file saved
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.
{
"message_id": "6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04"
}Use it when
An email brought a file the business needs to keep or read: a supplier's invoice, a signed form, photos of a damage.
- For reading a file once it is saved, use
files_read_text.
What it does
Save the attachments of one received email into the file store, each linked to the email, then read them like any file (files_read_text, documents_read_pdf, files_ocr). Ones saved before are kept, not saved again. Inline pictures (a signature's logo) and mail marked as spam are not saved. $0.001 per file saved; the original email is kept 30 days.
What comes back
saved: the files saved now, each with its file_id, name and size; attachments: every attachment of the email, with the file it became or why it was skipped (an inline picture, spam). Every reply also carries cost_usd and balance_usd.
Inputs
| Name | Type | What it is |
|---|---|---|
message_idRequired | string | Exactly 36 characters. |
The call
Over MCP, call email_save_attachments on https://api.conecto.chat/mcp/email. Over REST:
curl -X POST https://api.conecto.chat/v1/tools/email_save_attachments \
-H "Authorization: Bearer $CONECTO_KEY" \
-H "Content-Type: application/json" \
-d '{"message_id":"6e0b3f52-8d1a-4c7e-b2f9-3a5d7c9e1f04"}'When it refuses
A refused call costs nothing and says what to do next.
| Code | When | What to do |
|---|---|---|
not_found404 | No message of the business has that message_id. | Find the message with email_list_messages and use its message_id. |
invalid_input400 | The message was sent by the business; only received emails keep their original. | Use a received message: email_list_messages with direction in. |
gone410 | The original email is no longer kept (30 days) or could not be read. Nothing was charged. | Ask the sender for the files again. |
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* - Change an inbox
email_update_inboxChanges 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 - 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
Give this to your agent.
Set up Conecto from https://conecto.chat/SKILL.md