Microsoft 365

Send Outlook mail

m365_mail_send · Changes data · Markdown

Sends an email, or a reply in the same thread, as one of the company's mailboxes.

$0.001 a call

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

An example

Tell Lukas his combi steamer ships Monday, from support@.

Your agent callsm365_mail_send$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
{
  "mailbox": "support@hansenvoss.example",
  "to": [
    "lukas.meyer@hotel-elbblick.example"
  ],
  "subject": "Your combi steamer ships Monday",
  "body": "Hi Lukas,\n\nyour combi steamer leaves our warehouse on Monday, and our technician installs it on Tuesday.\n\nHansen & Voss Service"
}
What comes back
{
  "sent": true,
  "from": "support@hansenvoss.example",
  "to": [
    "lukas.meyer@hotel-elbblick.example"
  ],
  "cc": null,
  "reply_to": null
}

Use it when

The agent answers a customer from the company's own address.

  • For an address on Conecto's own mail domain, use email_send.

What it does

Send an email as one of the company's mailboxes, saved in its Sent Items: to, cc, subject and a text body. With reply_to_message_id it replies to that message's sender in the same thread instead. $0.001.

What comes back

sent; from; to; cc; reply_to. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
mailboxstringOne of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
toarray of stringsUp to 50 items.
ccarray of stringsUp to 50 items.
subjectstringUp to 300 characters.
bodyRequiredstring1 to 50,000 characters.
reply_to_message_idstringUp to 400 characters.

The call

Over MCP, call m365_mail_send on https://api.conecto.chat/mcp/microsoft365. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/m365_mail_send \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@hansenvoss.example","to":["lukas.meyer@hotel-elbblick.example"],"subject":"Your combi steamer ships Monday","body":"Hi Lukas,\n\nyour combi steamer leaves our warehouse on Monday, and our technician installs it on Tuesday.\n\nHansen & Voss Service"}'

When it refuses

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

CodeWhenWhat to do
not_connected409Microsoft 365 isn't connected yet.Connect it with m365_connect.
not_allowed403The mailbox is not one the agent may act as.Use a connected mailbox; the owner adds one by connecting again.
vendor_rejected502Microsoft refused: the app lacks a permission or consent, or the request.Ask the admin to grant what the message names.
invalid_input400A new email lacks to or subject, or an address is not valid.Give to and subject, or reply_to_message_id.

Give this to your agent.

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