Calendar

Calendar connects your flow to your Outlook calendar: it looks up the events in a period, creates events and online meetings, updates or deletes existing events and manages the calendars themselves (creating, renaming or deleting them).

It is useful when appointments are created or looked up from another process: a booking made through a form, an agent that needs to know whether there is a free slot, or a daily summary of meetings.

When to use it

• A client books an appointment and you want to create it in the calendar of the person who will see them.
• An AI agent needs to look at your calendar to suggest free slots.
• Every morning you want a summary of the day’s meetings.
• When an order or a project is cancelled, you want to delete the follow-up meetings.

Configuration

You need a Microsoft Outlook credential, which connects by signing in with your Microsoft account. See Credentials.

Field	What it does
Credential (required)	The Microsoft Outlook credential of the account whose calendar you use.
Operation (required)	What the component does. See Operations. By default, Get Calendar Events.
Mode	Basic shows only the essential fields; Advanced adds Search Query, Event Body and Location. By default, Basic.
Calendar	The calendar to work with. The list loads when you choose the credential. If you leave it empty, your main calendar is used. In the event operations.
Event Type	Event or Online Meeting. With Online Meeting, Is Online Meeting and Attendees appear. By default, Event. Only in Create Event.
Event ID	The event’s identifier. You get it with Get Calendar Events. In Update Event, Delete Event and Get Event by ID.
Event Subject	The event’s title. In Create Event and Update Event.
Event Body	The event’s description. Only with Mode set to Advanced, in Create Event and Update Event.
Location	Where the event takes place. Only with Mode set to Advanced, in Create Event and Update Event.
Is Online Meeting	When on, the event is created as an online meeting with a link to join. On by default. Only in Create Event.
Attendees	The attendees’ email addresses, separated by commas. Only in Create Event.
Search Start Time	In Get Calendar Events, the start of the period to look up. In Create Event and Update Event, the event’s start date and time. By default, the current date and time.
Search End Time	In Get Calendar Events, the end of the period to look up. In Create Event and Update Event, the event’s end date and time. By default, the current date and time.
Search Query	A text to keep only the events whose subject or content includes it. Only with Mode set to Advanced, in Get Calendar Events.
Calendar ID	The calendar’s identifier. You get it with Get Calendars. In Update Calendar, Delete Calendar and Get Calendar by ID.
Calendar Name	The calendar’s name. Required in Create Calendar and Update Calendar.

Operations

Operation	What it does
Get Calendar Events	Returns the events in the given period, with their subject, description, start, end, location, attendees and link.
Create Event	Creates an event or an online meeting. It needs a start and an end date.
Update Event	Changes an event’s subject, description, location or dates. Only the fields you fill in are changed.
Delete Event	Deletes an event.
Get Event by ID	Returns the full details of a specific event.
Get Calendars	Lists your calendars, with their identifier, name, owner, colour and whether it is the main one.
Create Calendar	Creates a new calendar.
Update Calendar	Renames a calendar.
Delete Calendar	Deletes a calendar.
Get Calendar by ID	Returns the details of a specific calendar.

Output

The Data output returns one item for each event or calendar found, or a single item with the result of the operation: the event created with its identifier and link, the confirmation of the deletion or the updated calendar.

You can connect the result to an agent so it uses it in its answer, or to an email or messaging component to send the appointment. The component can also be connected to an Agent as a tool, so the agent decides when to look up or create events. See Tool Mode.

Example

A physiotherapy clinic wants the appointments booked on its website to appear in the physiotherapist’s calendar.

1. The booking form reaches the flow with the patient’s name and the chosen time.
2. Add Calendar with the Create Event operation and the physiotherapist’s Microsoft Outlook credential.
3. In Event Subject, enter Session with followed by the patient’s name.
4. In Search Start Time and Search End Time, enter the start and end of the appointment, for example 2026-03-20T10:00:00 and 2026-03-20T11:00:00.
5. Connect the Data output to an email component that sends the confirmation to the patient.

Good practices

• Write full dates with a time, for example 2026-03-20T10:00:00.
• To update or delete an event you need its Event ID. Save it when you create the event, or look it up first with Get Calendar Events.
• Delete Calendar also deletes every event in that calendar.

Related components

• Outlook Calendar Webhook: start a flow when your calendar changes.
• Email: send and manage Outlook emails.
• Online Meetings: look up Teams meetings, their recordings and transcripts.