manage_event_as_organizer
Create, update, cancel, forward, or email attendees for events you organize in Microsoft 365 calendar. Handles recurring events and online meetings.
Instructions
Manage calendar events where you are the organizer (events you created). Actions: create, update, cancel, forward, email_attendees. WORKFLOW: For update, cancel, forward, and email_attendees actions, use cache number from browse_events or returned when creating an event. Returns: Event object with id, subject, start, end, location, attendees, body, recurrence, and online meeting details. Note: Conflict errors may occur when updating event times that overlap with existing events.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | List of 'cc' recipient email addresses for email_attendees action (optional, defaults to optional event attendees) | |
| to | No | List of 'to' recipient email addresses for email_attendees action (optional, defaults to required event attendees) | |
| end | No | End date and time in your local timezone. Example: '2024-01-01T15:30' or '2024-01-01 15:30'. The system will automatically convert to UTC using the timezone parameter or your timezone settings from your Microsoft 365 profile or .env configuration. Required for create, optional for update | |
| body | No | Event body content in HTML format (optional for create, update, reply). IMPORTANT: (1) Do NOT use <br> between <p> tags - use </p><p> directly for paragraph separation. (2) Do NOT add newlines or whitespace between HTML block elements - keep HTML compact. Use <p> for paragraphs, <strong>/<em> for emphasis. | |
| start | No | Start date and time in your local timezone. Example: '2024-01-01T14:30' or '2024-01-01 14:30'. The system will automatically convert to UTC using the timezone parameter or your timezone settings from your Microsoft 365 profile or .env configuration. Required for create, optional for update | |
| action | Yes | Action to perform: 'create' to create a new calendar event, 'update' to update an existing event, 'cancel' to cancel an event and send cancellation notifications to attendees, 'forward' to forward event by adding new optional attendees, 'email_attendees' to send email to event attendees using event body as content (to=required attendees, cc=optional attendees) | |
| comment | No | Optional comment for cancel, forward actions | |
| subject | No | Event subject (required for create, optional for update) | |
| location | No | Event location (optional for create, update) | |
| timezone | No | Timezone for the event in IANA format. Examples: 'Asia/Singapore', 'America/New_York', 'Europe/London', 'UTC'. Optional for create and update actions - if not provided, will use your timezone settings from your Microsoft 365 profile or .env configuration | |
| attendees | No | List of required attendee email addresses (optional for create, update, required for forward) | |
| recurrence | No | Recurrence pattern for the event (optional for create, update). Defines how the event repeats | |
| cache_number | No | Cache number from browse_events or returned when creating an event (required for update, cancel, forward, email_attendees actions, e.g., 1, 2, 3) | |
| email_subject | No | Email subject for email_attendees action (optional, default: 'Re: Event') | |
| isOnlineMeeting | No | Whether to create the event as an online meeting (optional for create, update). If true, creates a Teams meeting when onlineMeetingProvider is 'teamsForBusiness'. For other providers (Zoom, Google Meet, etc.), set isOnlineMeeting to true and include the join link in the body field | |
| body_content_type | No | Body content type (optional for create, update, default: HTML) | |
| optional_attendees | No | List of optional attendee email addresses (optional for create, update) | |
| onlineMeetingProvider | No | Online meeting provider (optional for create, update). Use 'teamsForBusiness' for Teams meetings, 'skypeForBusiness' for Skype for Business, 'skypeForConsumer' for Skype Consumer, or 'unknown' for other providers. For 'unknown' or other providers (Zoom, Google Meet, etc.), include the join link in the body field. Requires isOnlineMeeting to be true |