Google Calendar

The Google Calendar connector enables you to automate Google Calendar operations, including creating and managing events, checking availability, and managing calendars.

To use the Google Calendar connector, you first need to connect your Google account using the following steps:

1. Log in to your Contentstack account.
2. After logging in, click the App Switcher icon, then select Agent OS from the list.
   Click to enlarge
3. Click + New Project or select an existing one.
4. In the top navigation panel, click Automations.
5. Click Configure Action Step from the left navigation panel and then Action Step to configure third-party services.
6. Within the Choose Connector, click the Google Calendar connector.
   Click to enlarge
7. Under Choose an Action, select any action (for example, Create an Event).
8. In the Configure Action section, click + Add New Account to add your Google account.
9. In the Manage Permissions modal, review the permission that will be granted: Full access to calendars (read, write, and delete).
10. Click the Authorize button.

This sets up your Google account for the Google Calendar connector.

Perform the following steps to set up the Google Calendar connector:

1. From the left navigation panel, click Configure Action Step.
2. Then, click Action Step to configure third-party services.
3. Within the Choose Connector, click the Google Calendar connector.
4. Under Choose an Action, you will see the actions grouped under Calendar and Event, described below:

The Check Availability action checks free and busy time slots for the selected calendars. To use the Check Availability action, follow the steps below:

1. Under Choose an Action tab, select the Check Availability action.
2. On the Check Availability Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Enter comma-separated calendar IDs to check availability for in the Calendar ID field, e.g., primary, [email protected].
   3. Enter the start date and time for the availability check in ISO 8601 format in the Start Date/Time field, e.g., 2024-01-15T09:00:00Z.
   4. Enter the end date and time for the availability check in ISO 8601 format in the End Date/Time field, e.g., 2024-01-15T18:00:00Z.
   5. Click the Show Optional Fields toggle button to use this optional field:
      1. Enter the time zone to use for the query in the Time Zone field, e.g., America/New_York.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Create a Calendar action creates a new secondary calendar in Google Calendar. To use the Create a Calendar action, follow the steps below:

1. Under Choose an Action tab, select the Create a Calendar action.
2. On the Create a Calendar Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Enter a name for the new calendar in the Calendar Name field.
   3. Click the Show Optional Fields toggle button to use these optional fields:
      1. Enter a description for the calendar in the Description field.
      2. Enter the default time zone for the calendar in the Time Zone field, e.g., America/New_York.
      3. Enter the calendar's location in the Location field.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Delete a Calendar action deletes a secondary calendar. You cannot delete the primary calendar. To use the Delete a Calendar action, follow the steps below:

1. Under Choose an Action tab, select the Delete a Calendar action.
2. On the Delete a Calendar Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to delete in the Calendar Name field. You cannot delete your primary calendar.
      Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Get Calendar action retrieves details of a specific Google Calendar. To use the Get Calendar action, follow the steps below:

1. Under Choose an Action tab, select the Get Calendar action.
2. On the Get Calendar Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to retrieve details for in the Calendar Name field.
      Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Create an Event action creates a new event in Google Calendar. To use the Create an Event action, follow the steps below:

1. Under Choose an Action tab, select the Create an Event action.
2. On the Create an Event Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to create the event in, in the Calendar Name field.
   3. Enter a title for the event in the Event Title field.
   4. Enter the start date and time in ISO 8601 format in the Start Date/Time field, e.g., 2024-01-15T09:00:00. For all-day events, use date format only, e.g., 2024-01-15.
   5. Enter the end date and time in ISO 8601 format in the End Date/Time field, e.g., 2024-01-15T10:00:00. For all-day events, use date format only, e.g., 2024-01-16.
   6. Click the Show Optional Fields toggle button to use these optional fields:
      1. Enter the time zone for the event in the Time Zone field, e.g., America/New_York. Leave empty to use the calendar's default.
      2. Enter the location of the event in the Location field.
      3. Enter comma-separated email addresses for attendees in the Attendees field.
      4. Enter a recurrence rule in RRULE format in the Recurrence Rule field, e.g., RRULE:FREQ=WEEKLY;COUNT=5.
      5. Set a reminder this many minutes before the event in the Reminder field.
      6. Select who can see this event from the Visibility drop-down: Default, Private, Public, and Confidential.
      7. Select a Color from the dropdown (Lavender, Sage, Grape, Flamingo, and Orange) or enter a color ID for the event, from 1 to 11.
         Note: The Color drop-down lists named colors while the field instruction refers to a numeric ID (1–11).
      8. Mark the All-day event checkbox to indicate whether this is an all-day event.
      9. Mark the Send notifications checkbox to send email notifications to attendees.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Delete an Event action deletes an event from Google Calendar. To use the Delete an Event action, follow the steps below:

1. Under Choose an Action tab, select the Delete an Event action.
2. On the Delete an Event Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to delete the event from, in the Calendar Name field.
   3. Select the event name to delete in the Event Name field.
   4. Click the Show Optional Fields toggle button to use this optional field:
      1. Mark the Send notifications checkbox to send cancellation notifications to attendees.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Find Events action searches and lists events from Google Calendar with optional filters. To use the Find Events action, follow the steps below:

1. Under Choose an Action tab, select the Find Events action.
2. On the Find Events Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to search for events in, in the Calendar Name field.
   3. Click the Show Optional Fields toggle button to use these optional fields:
      1. Enter a search term to filter events in the Search Query field.
      2. Enter the lower bound for the event start time in ISO 8601 format in the Start Date/Time field, e.g., 2024-01-15T00:00:00Z. Defaults to the current time.
      3. Enter the upper bound for the event end time in ISO 8601 format in the End Date/Time field, e.g., 2024-01-31T23:59:59Z.
      4. Enter the maximum number of events to return in the Maximum Results field. Default is 10, maximum is 250.
      5. Select the order of results from the Order By drop-down: Start time, Last updated. Only works when single events are expanded.
      6. Mark the Expand recurring events checkbox to expand recurring events into individual instances.
      7. Mark the Show deleted events checkbox to include deleted events in the results.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Get an Event action fetches the details of a specific event from the Google Calendar. To use the Get an Event action, follow the steps below:

1. Under Choose an Action tab, select the Get an Event action.
2. On the Get an Event Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to fetch the event from, in the Calendar Name field.
   3. Select the event name to fetch its details in the Event Name field.
      Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Quick Add Event action creates an event from a natural language text string (e.g., "Meeting with John tomorrow at 3 PM"). To use the Quick Add Event action, follow the steps below:

1. Under Choose an Action tab, select the Quick Add Event action.
2. On the Quick Add Event Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar to create the event in, in the Calendar Name field.
   3. Enter the event in natural language in the Event Text field, e.g., "Meeting with John tomorrow at 3 PM" or "Dentist appointment on Friday at 2:30 PM."
   4. Click the Show Optional Fields toggle button to use this optional field:
      1. Mark the Send notifications checkbox to send email notifications to attendees.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

The Update an Event action updates an existing event in Google Calendar. To use the Update an Event action, follow the steps below:

1. Under Choose an Action tab, select the Update an Event action.
2. On the Update an Event Configure Action page, enter the details given below:
   1. Click + Add New Account button to connect your Google account as shown in the Prerequisites step.
   2. Select the calendar containing the event in the Calendar Name field.
   3. Select the event to update in the Event Name field.
   4. Click the Show Optional Fields toggle button to use these optional fields:
      1. Enter a new description for the event in the Event Description field.
      2. Enter an updated location for the event in the Location field.
      3. Enter the updated start date and time, in ISO 8601 format, in the Start Date/Time field.
      4. Enter the updated end date and time, in ISO 8601 format, in the End Date/Time field.
      5. Select the updated time zone for the event from the Time Zone field.
      6. Enter comma-separated email addresses for attendees in the Attendees field. This replaces the existing attendee list.
      7. Select the updated visibility setting from the Visibility dropdown: Default, Private, Public, Confidential.
      8. Select the updated Color from the dropdown (Lavender, Sage, Grape, Flamingo, Orange) or enter the updated color ID for the event, from 1 to 11.
      9. Mark the Send notifications checkbox to send email notifications to attendees about the update.
         Click to enlarge
3. Click Proceed.
4. Check if the details are correct. If yes, then click Test Action.
5. You will get the response(s). Once set, click Save and Exit.

This completes the Google Calendar connector's setup.