Google Calendar

1. Overview

Google Calendar is a free online calendar service provided by Google, allowing users to create and manage personal or team schedules. Through the Google Calendar API, developers can programmatically access and manipulate users' calendar data.

With GoInsight's Google Calendar node, you can seamlessly integrate calendar management features into your automated workflows. You can achieve full lifecycle management of calendar events and scheduling, including:

• Creating and deleting calendar events
• Querying and updating details of existing events
• Bulk fetching a list of events within a specified time range
• Checking time availability to avoid scheduling conflicts

2. Prerequisites

Before using this node, you need to meet the following conditions:

• Google Account: You must have a valid Google account.
• Google Calendar API Access: You need to enable the Calendar API in the Google Cloud Console and obtain the appropriate credentials.
• Calendar Permissions: Ensure you have the proper read and write permissions for the calendar you intend to operate on.

3. How to Get Credentials

For a detailed guide on how to obtain and configure credentials, please refer to our official documentation: Credential Configuration Guide.

4. Supported Operations

This node primarily operates on two core resources: Event and Availability.

Summary

Operation Details

Create an Event

Adds a new event to the calendar.

Input Parameters:

• CalendarId: The unique identifier of the calendar.
• EventSummary: The summary or title of the event.
• EventStartTime: The start time of the event, must be in RFC3339 format, e.g., '2025-07-23T10:00:00-07:00'.
• EventEndTime: The end time of the event, must be in RFC3339 format, e.g., '2025-07-23T11:00:00-07:00'.
• EventDescription: A detailed description of the event.

Output:

• EventId (string): The unique identifier of the created event.
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

Get an Event

Retrieves the details of a single specified event.

Input Parameters:

• CalendarId: The unique identifier of the calendar.
• EventId: The unique identifier of the event.

Output:

• Event (object): The detailed information of the retrieved event. Will be an empty dictionary on failure.
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

Get Many Events

Gets multiple events.

Input Parameters:

• CalendarId: The unique identifier of the calendar.

Options:

• TimeMin: The minimum time for the event query. E.g., "2025-07-01T00:00:00Z".
• TimeMax: The maximum time for the event query. E.g., "2025-07-31T23:59:59Z".
• MaxResults: The maximum number of events to retrieve.

Output:

• Events (string): A JSON string list where each element represents an event.
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

Update an Event

Updates an existing event.

Input Parameters:

• CalendarId: The unique identifier of the calendar.
• EventId: The unique identifier of the event.
• EventBody: A JSON string containing the event update information. E.g., "{\\\"summary\\\":\\\"Updated Event Title\\\",\\\"description\\\":\\\"Updated description for the event\\\",\\\"start\\\":{\\\"dateTime\\\":\\\"2025-08-01T10:00:00-07:00\\\"},\\\"end\\\":{\\\"dateTime\\\":\\\"2025-08-01T11:00:00-07:00\\\"}}".

Output:

• UpdatedEvent (string): The information of the updated event.
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

Delete an Event

Deletes a specified event.

Input Parameters:

• CalendarId: The unique identifier of the calendar.
• EventId: The unique identifier of the event.

Output:

• Deleted (bool): Indicates whether the event was successfully deleted (True for success, False for failure).
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

Get Availability

Checks for free time slots within a specified period.

Input Parameters:

• CalendarId: The unique identifier of the calendar.
• StartTime: The start time of the query. E.g., "2025-08-01T10:00:00Z".
• EndTime: The end time of the query. E.g., "2025-08-01T10:00:00Z".

Options:

• TimeZone: The timezone identifier, defaults to "UTC".

Output:

• IsAvailable (bool): Whether the time slot is free. True indicates no conflicting events, False indicates a conflict.
• FreeBusyInfo (string): The raw freebusy API response, returned as a JSON string.
• StatusCode (number): The HTTP status code returned by the API (e.g., 200 for a successful list request, 201 for a successful creation, 204 for a successful deletion) or 500 for an internal error during processing.
• ErrorMessage (string): A detailed error message, which is empty on success.

5. Example Usage

This section will guide you through creating a simple workflow to create a new event in your Google Calendar.

This example workflow consists of three main parts: Start -> Create an Event -> Answer, demonstrating how to use GoInsight to automatically create calendar events.

Step-by-Step Guide

1. Add Tool Node:
   • In the workflow canvas, click the "+" sign to add a new node.
   • In the pop-up panel, select the "Tools" tab.
   • In the tool list, find and select Google Calendar.
   • In the list of supported operations for Google Calendar, click to select Create an Event, which will add a corresponding node to the canvas.
2. Configure Node:
   • Click on the newly added Create an Event node, and its configuration panel will expand on the right.
   • Credential Configuration: At the top of the panel, find the credential field. Click the dropdown menu and select your pre-configured Google Calendar credential.
   • Parameter Entry:
   • CalendarId: Enter the ID of the calendar to add the event to, such as "primary" (for the primary calendar) or a specific calendar ID.
   • EventSummary: Enter a title for your new event, for example, "Team Meeting".
   • EventStartTime: Enter the event start time, which must be in RFC3339 format, for example, "2025-07-23T10:00:00-07:00".
   • EventEndTime: Enter the event end time, also using RFC3339 format, for example, "2025-07-23T11:00:00-07:00".
   • EventDescription: Enter a detailed description for the event, for example, "Discuss the project plan for the next quarter".
3. Run and Validate:
   • When all required parameters are correctly filled in, the error prompt in the top right corner of the workflow canvas will disappear.
   • Click the "Run" button in the top right corner of the canvas to execute the workflow.
   • After a successful execution, you can click the log icon in the top right corner to view the node's detailed input and output, and verify that the event was created successfully.

Upon completing these steps, your workflow will be fully configured. Clicking "Run" will successfully create a new calendar event in your Google Calendar, and you can view this newly created event in your calendar application.

6. FAQs

Q: Why do I get a permission denied error when creating an event?

A: Please check the following:

• Ensure your Google API credentials have read/write permissions for the Calendar API.
• Verify that you have editing permissions for the specified calendar.
• Check if the OAuth scopes include the necessary calendar permissions.

Q: What format should I use for the time?

A: Time must be in RFC3339 format, including timezone information:

• Correct format: 2025-07-23T10:00:00-07:00
• Incorrect format: 2025-07-23 10:00:00 or July 23, 2025 10:00 AM

Q: How do I find my Calendar ID?

A: You can get the Calendar ID in the following ways:

• Use "primary" to refer to your main calendar.
• Check the ID of a specific calendar in Google Calendar settings.
• Retrieve it via the Calendar List endpoint of the Google Calendar API.

Q: Why does checking availability always return unavailable?

A: Please check the following settings:

• Ensure the start time is earlier than the end time.
• Verify that the timezone settings are correct.
• Check if the specified Calendar ID is valid.

7. Official Documentation

For more advanced features and detailed API parameter descriptions, please refer to the: Official Google Calendar API Documentation