> For the complete documentation index, see [llms.txt](https://docs.n8n.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.n8n.io/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar/event-operations.md).

# Event operations

Use these operations to create, delete, get, and update events in Google Calendar. Refer to [Google Calendar](/integrations/builtin/app-nodes/n8n-nodes-base.googlecalendar.md) for more information on the Google Calendar node itself.

## Create <a href="#create" id="create"></a>

Use this operation to add an event to a Google Calendar.

Enter these parameters:

* **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google.md).
* **Resource**: Select **Event**.
* **Operation**: Select **Create**.
* **Calendar**: Choose a calendar you want to add an event to. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
* **Start Time**: The start time for the event. By default, uses an expression evaluating to the current time (`{{ $now }}`).
* **End Time**: The end time for the event. By default, this uses an expression evaluating to an hour from now (`{{ $now.plus(1, 'hour') }}`).
* **Use Default Reminders**: Whether to enable default reminders for the event according to the calendar configuration.

### Options <a href="#options" id="options"></a>

* **All Day**: Whether the event is all day or not.
* **Attendees**: Attendees to invite to the event.
* **Color Name or ID**: The color of the event. Choose from the list or specify the ID using an expression.
* **Conference Data**: Creates a conference link (Hangouts, Meet, etc.) and attaches it to the event.
* **Description**: A description for the event.
* **Guests Can Invite Others**: Whether attendees other than the organizer can invite others to the event.
* **Guests Can Modify**: Whether attendees other than the organizer can modify the event.
* **Guests Can See Other Guests**: Whether attendees other than the organizer can see who the event's attendees are.
* **ID**: Opaque identifier of the event.
* **Location**: Geographic location of the event as free-form text.
* **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
* **Repeat Frequency**: The repetition interval for recurring events.
* **Repeat How Many Times?**: The number of instances to create for recurring events.
* **Repeat Until**: The date at which recurring events should stop.
* **RRULE**: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.
* **Send Updates**: Whether to send notifications about the creation of the new event.
* **Show Me As**: Whether the event blocks time on the calendar.
* **Summary**: The title of the event.

Refer to the [Events: insert | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/insert) API documentation for more information.

## Delete <a href="#delete" id="delete"></a>

Use this operation to delete an event from a Google Calendar.

Enter these parameters:

* **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google.md).
* **Resource**: Select **Event**.
* **Operation**: Select **Delete**.
* **Calendar**: Choose a calendar you want to delete an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
* **Event ID**: The ID of the event to delete.

### Options <a href="#options" id="options"></a>

* **Send Updates**: Whether to send notifications about the deletion of the event.

Refer to the [Events: delete | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/delete) API documentation for more information.

## Get <a href="#get" id="get"></a>

Use this operation to retrieve an event from a Google Calendar.

Enter these parameters:

* **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google.md).
* **Resource**: Select **Event**.
* **Operation**: Select **Get**.
* **Calendar**: Choose a calendar you want to get an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
* **Event ID**: The ID of the event to get.

### Options <a href="#options" id="options"></a>

* **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
* **Return Next Instance of Recurrent Event**: Whether to return the next instance of a recurring event instead of the event itself.
* **Timezone**: The timezone used in the response. By default, uses the n8n timezone.

Refer to the [Events: get | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/get) API documentation for more information.

## Get Many <a href="#get-many" id="get-many"></a>

Use this operation to retrieve more than one event from a Google Calendar.

Enter these parameters:

* **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google.md).
* **Resource**: Select **Event**.
* **Operation**: Select **Get Many**.
* **Calendar**: Choose a calendar you want to get an event from. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
* **Return All**: Whether to return all results or only up to a given limit.
* **Limit**: (When "Return All" isn't selected) The maximum number of results to return.
* **After**: Retrieve events that occur after this time. At least part of the event must be after this time. By default, this uses an expression evaluating to the current time (`{{ $now }}`). Switch the field to "fixed" to select a date from a date widget.
* **Before**: Retrieve events that occur before this time. At least part of the event must be before this time. By default, this uses an expression evaluating to the current time plus a week (`{{ $now.plus({ week: 1 }) }}`). Switch the field to "fixed" to select a date from a date widget.

### Options <a href="#options" id="options"></a>

* **Fields**: Specify the fields to return. By default, returns a set of commonly used fields predefined by Google. Use "\*" to return all fields. You can find out more in [Google Calendar's documentation on working with partial resources](https://developers.google.com/calendar/api/guides/performance#partial).
* **iCalUID**: Specifies an event ID (in the iCalendar format) to include in the response.
* **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
* **Order By**: The order to use for the events in the response.
* **Query**: Free text search terms to find events that match. This searches all fields except for extended properties.
* **Recurring Event Handling**: What to do for recurring events:
  * **All Occurrences**: Return all instances of the recurring event for the specified time range.
  * **First Occurrence**: Return the first event of a recurring event within the specified time range.
  * **Next Occurrence**: Return the next instance of a recurring event within the specified time range.
* **Show Deleted**: Whether to include deleted events (with status equal to "cancelled") in the results.
* **Show Hidden Invitations**: Whether to include hidden invitations in the results.
* **Timezone**: The timezone used in the response. By default, uses the n8n timezone.
* **Updated Min**: The lower bounds for an event's last modification time (as an [RFC 3339 timestamp](https://datatracker.ietf.org/doc/html/rfc3339))

Refer to the [Events: list | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/list) API documentation for more information.

## Update <a href="#update" id="update"></a>

Use this operation to update an event in a Google Calendar.

Enter these parameters:

* **Credential to connect with**: Create or select an existing [Google Calendar credentials](/integrations/builtin/credentials/google.md).
* **Resource**: Select **Event**.
* **Operation**: Select **Update**.
* **Calendar**: Choose a calendar you want to add an event to. Select **From list** to choose the title from the dropdown list or **By ID** to enter a calendar ID.
* **Event ID**: The ID of the event to update.
* **Modify**: For recurring events, choose whether to update the recurring event or a specific instance of the recurring event.
* **Use Default Reminders**: Whether to enable default reminders for the event according to the calendar configuration.
* **Update Fields**: The fields of the event to update:
  * **All Day**: Whether the event is all day or not.
  * **Attendees**: Attendees to invite to the event. You can choose to either add attendees or replace the existing attendee list.
  * **Color Name or ID**: The color of the event. Choose from the list or specify the ID using an expression.
  * **Description**: A description for the event.
  * **End**: The end time of the event.
  * **Guests Can Invite Others**: Whether attendees other than the organizer can invite others to the event.
  * **Guests Can Modify**: Whether attendees other than the organizer can make changes to the event.
  * **Guests Can See Other Guests**: Whether attendees other than the organizer can see who the event's attendees are.
  * **ID**: Opaque identifier of the event.
  * **Location**: Geographic location of the event as free-form text.
  * **Max Attendees**: The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only returns the participant.
  * **Repeat Frequency**: The repetition interval for recurring events.
  * **Repeat How Many Times?**: The number of instances to create for recurring events.
  * **Repeat Until**: The date at which recurring events should stop.
  * **RRULE**: Recurrence rule. When set, ignores the Repeat Frequency, Repeat How Many Times, and Repeat Until parameters.
  * **Send Updates**: Whether to send notifications about the creation of the new event.
  * **Show Me As**: Whether the event blocks time on the calendar.
  * **Start**: The start time of the event.
  * **Summary**: The title of the event.
  * **Visibility**: The visibility of the event:
    * **Confidential**: The event is private. This value is provided for compatibility.
    * **Default**: Uses the default visibility for events on the calendar.
    * **Public**: The event is public and the event details are visible to all readers of the calendar.
    * **Private**: The event is private and only event attendees may view event details.

Refer to the [Events: update | Google Calendar](https://developers.google.com/calendar/api/v3/reference/events/update) API documentation for more information.