Create Calendar Event

The Create Calendar Event node enables automation workflows to schedule calendar events in a user's Microsoft Outlook calendar. This is especially useful for automating appointment creation, reminders, and collaborative scheduling within an enterprise environment.

Node Summary

This node integrates with Microsoft Graph APIs via service accounts to create a calendar event. The user must specify the event title, description, start and end dates, and optionally a list of attendee email addresses.

The node will validate inputs, retrieve the appropriate Microsoft service account, and submit the calendar event to the specified user's calendar.

Inputs

Label	Type	Required	Description
Event Title	text	Yes	Title of the calendar event (e.g., "Team Standup").
Event Description	text	Yes	Description or notes for the event.
Start Date	dateTime	Yes	Start date and time of the event.
End Date	dateTime	Yes	End date and time of the event. Must be later than the start date.
Attendees	text	No	JSON array of email addresses to invite (e.g., ["user1@domain.com"]).
ThirdParty-Microsoft	text	Yes	The ID of the Microsoft service account to be used.

Note: The ThirdParty-Microsoft input is passed implicitly when using the system's service account framework and is not shown to the user in the modal form.

Outputs

This node does not produce any output variables, but it will complete with a status indicating success or failure. If successful, the event is created in the calendar of the user associated with the service account.

Behavior

• The node validates required fields and ensures the start date is not later than the end date.
• It uses a Microsoft service token to create the event on behalf of the user.
• If the list of attendees is empty, the event will be created without invitees.
• Any failures in the Microsoft Graph API or configuration will cause the task to return a failure status.

Error Handling

• Missing Service Account: Returns "Required Service Accounts not found".
• Empty Attendees List: Returns "Required Parameters not found" if attendees are provided but parsed as empty.
• Invalid Date Range: Returns "Start Date cannot be greater than End Date".
• Event Creation Failure: Returns "Failed to create calendar event".

Example

Input Configuration:

• Event Title: Project Kickoff
• Event Description: Initial project kickoff meeting with stakeholders.
• Start Date: 2025-07-01T10:00:00Z
• End Date: 2025-07-01T11:00:00Z
• Attendees: ["alice@example.com", "bob@example.com"]

This will create a one-hour meeting titled "Project Kickoff" and send invites to the specified attendees.

---