Skip to content
Nappai Documentation

Calendar Calendars

Calendar Calendars manages the calendars in your Google Calendar account, not the events inside them: create a new calendar, look up the details of a calendar or the list of all yours, change its name or description, and delete it.

It is useful when you want one calendar per room, per professional or per project, created or removed automatically. To work with events, use Calendar Event.

When to use it

  • Every time a new professional joins, you want to create their own appointments calendar.
  • You need the ID of a calendar to use it in another step of the flow.
  • You want to review which calendars an account has.
  • When a project ends, you want to delete the calendar you used for it.

Configuration

You need a Google Calendar credential, which connects by signing in with your Google account. To create, change or delete calendars, the credential needs the Create, Update, Delete, Read access. See Credentials.

FieldWhat it does
Credential (required)The Google Calendar credential of the account you work with.
OperationWhat the component does. See Operations. Default: Create.
Input TypeIn Get, Update and Delete, how you point to the calendar: Selection to choose it from the list or Id to type its ID. Default: Selection.
Calendar SelectionWith Input Type on Selection. The calendar you work with. The list loads when you choose the credential and shows the calendars you can write to.
Calendar IdWith Input Type on Id. The calendar ID. Required in Update and Delete. In Get, if you leave it empty, all your calendars are returned.
SummaryOnly in Create and Update. The calendar name. Required in Create.
DescriptionOnly in Create and Update. A short description of the calendar.

Operations

OperationWhat it does
CreateCreates a new calendar in your account.
GetReturns the details of a calendar, or of all of them if you use Id and leave Calendar Id empty.
UpdateChanges the name or description of a calendar. Only the fields you fill in are changed.
DeleteDeletes a calendar with all its events.

Output

The Data output returns the calendars you worked with, with their ID (id), name (summary), description and time zone. In Get with all calendars you get one item per calendar. In Delete it returns a confirmation.

You can use the ID in another step of the flow or connect the result to an AI agent. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A physiotherapy centre wants one calendar per physiotherapist.

  1. The new professional reaches the flow with their name.
  2. Add Calendar Calendars with the Create operation.
  3. In Summary put Appointments followed by the professional’s name and in Description their specialty.
  4. From then on, the calendar appears in Calendar Selection of Calendar Event to create their appointments.

Good practices

  • Delete also deletes every event in the calendar and cannot be undone. Your primary calendar cannot be deleted.
  • To see all your calendars at once, use Get with Input Type on Id and Calendar Id empty.