Add an Outlook event

m365_calendar_create · Changes data · Markdown

Adds an event to a mailbox's calendar and invites its attendees, with a Teams link if asked.

$0.001 a call

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

Book Sophie's test kitchen demo on Saturday at 11:30 with a Teams link.

Your agent callsm365_calendar_create$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",
  "subject": "Test kitchen demo: Sophie Lange",
  "start": "2026-10-24T11:30",
  "end": "2026-10-24T12:15",
  "timezone": "Europe/Berlin",
  "attendees": [
    "sophie.lange@example.com"
  ],
  "online_meeting": true
}

What comes back

{
  "mailbox": "support@hansenvoss.example",
  "event": {
    "id": "AAMkAGI2TG94AAA=",
    "subject": "Test kitchen demo: Sophie Lange",
    "start": "2026-10-24T09:30:00.0000000",
    "end": "2026-10-24T10:15:00.0000000",
    "location": null,
    "organizer": "support@hansenvoss.example",
    "attendees": [
      "sophie.lange@example.com"
    ],
    "online_meeting": "https://teams.microsoft.com/l/meetup-join/19%3ameeting_example",
    "cancelled": false,
    "link": "https://outlook.office365.com/owa/?itemid=AAMkAGI2TG94AAA%3D"
  }
}

Use it when

A customer or colleague agreed a time.

For a booking page where customers pick their own time, use calendar_save_meeting_type.

What it does

Put an event in a mailbox's calendar and invite its attendees, with a Teams meeting when asked. Times with an offset, or local to `timezone`. $0.001.

What comes back

mailbox; event: id, subject, start, end, location, organizer, attendees, online_meeting and link. Every reply also carries cost_usd and balance_usd.

Inputs

Name	Type	What it is
`mailbox`	string	One of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
`subject`Required	string	1 to 255 characters.
`start`Required	string	Up to 40 characters.
`end`Required	string	Up to 40 characters.
`timezone`	string	Up to 60 characters.
`attendees`	array of strings	Up to 50 items.
`location`	string	Up to 255 characters.
`body`	string	Up to 10,000 characters.
`online_meeting`	boolean	Default: false.

The call

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

Terminal

curl -X POST https://api.conecto.chat/v1/tools/m365_calendar_create \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@hansenvoss.example","subject":"Test kitchen demo: Sophie Lange","start":"2026-10-24T11:30","end":"2026-10-24T12:15","timezone":"Europe/Berlin","attendees":["sophie.lange@example.com"],"online_meeting":true}'

When it refuses

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

Code	When	What to do
`not_connected`409	Microsoft 365 isn't connected yet.	Connect it with m365_connect.
`not_allowed`403	The mailbox is not one the agent may act as.	Use a connected mailbox; the owner adds one by connecting again.
`vendor_rejected`502	Microsoft refused: the app lacks a permission or consent, or the request.	Ask the admin to grant what the message names.
`invalid_input`400	A time or address is not valid, or end is not after start.	Fix what the message names.

More Microsoft 365 tools

All 11 tools

Give this to your agent.

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

Add an Outlook event

An example

Use it when

What it does

What comes back

Inputs

The call

When it refuses

More Microsoft 365 tools

Give this to your agent.