Microsoft Outlook Calendar

The Microsoft Outlook Calendar piece in ZBrain Flow allows you to automate calendar operations such as creating, deleting, and listing events. It also includes an option to make custom API calls to Microsoft Outlook Calendar endpoints for advanced use cases. This piece helps you build workflows that interact with user or team calendars—useful for scheduling tasks, syncing appointments, or triggering actions based on calendar events.

How to use Microsoft Outlook Calendar in ZBrain Flow

Select Microsoft Outlook Calendar

• Click on the '+' button in the Flow and search for ‘Microsoft Outlook Calendar’. Select the piece.

• Decide on the calendar action you want to automate. Available options include:

  • ‘Create a new event in a calendar’ – Schedule a new event by providing details like title, time, location, and attendees.

  • ‘Delete an event in a calendar’ – Remove a scheduled event using its ID or reference.

  • ‘List events in a calendar’ – Fetch a list of upcoming or past events from a specified calendar.

  • ‘Custom API Call’ – Make a direct API call to Microsoft Outlook Calendar endpoints for specific or advanced use cases.

How to connect to Microsoft Outlook Calendar

Before using any action within the Microsoft Outlook Calendar piece—whether it's creating, deleting, or listing calendar events—you must first set up a connection. This connection step is required once and allows ZBrain Flow to interact securely with your Outlook Calendar account. To create a connection:

• In the connection dropdown, click on 'create connection'. A setup window will appear where you need to fill in the following fields:

  • ‘Connection Name’: Give your connection a recognizable name (e.g., Microsoft Outlook Calendar).

  • ‘Redirect URL’: Leave this field as it is — https://secrets.activepieces.com/redirect.

  • ‘Client ID’: Enter the client ID provided by your Microsoft Azure app.

  • ‘Client Secret’: Enter the client secret from the same Azure app.

After filling in these details, click ‘Connect’ to authorize access and complete authentication. Once authorized, click ‘Save’ to finalize the connection setup.

How to create a calendar event in Microsoft Outlook Calendar

Configuration steps:

• In the ‘Connection’ field, select an existing Microsoft Outlook Calendar connection or create a new one if not already connected.

• Choose the target calendar from the ‘Calendar’ field.

• Enter the title of the event in the ‘Title of the event’ field.

• Provide the start time of the event in the ‘Start date time of the event’ field.

• Fill the ‘End date time of the event’ field, or leave it blank to default to 30 minutes after the start time.

• Select the relevant time zone from the ‘Timezone’ field.

• Optionally, enter the event location in the ‘Location’ field.

How to delete an event from Microsoft Outlook Calendar

Configuration steps:

• In the ‘Connection’ field, select an existing Microsoft Outlook Calendar connection or create a new one.

• Choose the target calendar from the ‘Calendar’ field.

• Enter the event’s unique identifier in the ‘Event ID’ field to specify which event should be deleted.

How to list events in Microsoft Outlook Calendar

Configuration steps:

• Select a connection from the ‘Connection’ field or create a new Microsoft Outlook Calendar connection.

• Choose the calendar you want to fetch events from using the ‘Calendar’ field.

• In the ‘Filter’ field, enter an optional search query to narrow down the event results. You can refer to Microsoft’s filter query documentation for supported syntax.

How to make a custom API call with Microsoft Outlook Calendar

Configuration steps:

• Select an existing connection from the ‘Connection’ field or create a new Microsoft Outlook Calendar connection.

• In the ‘URL’ field, enter the complete Microsoft Graph API endpoint you want to access, such as https://graph.microsoft.com/v1.0/me.

• Select the HTTP method in the ‘Method’ field (GET, POST, PUT, PATCH, DELETE, etc.).

• Under ‘Headers’, add any custom headers required for the call. Authorization headers are automatically handled by the connection, so you don’t need to add them.

• If needed, add query parameters under the ‘Query Parameters’ field.

• Enter the request body in the ‘Body’ field, applicable for methods like POST or PUT.

• Optionally, enable ‘No Error on Failure’ if you want the flow to continue even if the API call fails.

• Set a value in the ‘Timeout (in seconds)’ field to control how long the system should wait for a response before ending the request.