Skip to content
Nappai Documentation

Calendar Event

Calendar Event connects your flow to your Google Calendar to manage events: create an appointment or a meeting, with guests and a Google Meet link if you want, look up the events in a period, change an existing event or delete it.

It is useful when appointments come out of another process, for example a booking a customer makes through a form or a request an AI agent handles, and you want the event to appear in the calendar without creating it by hand.

When to use it

  • A customer books an appointment on your website and you want to create the event and invite them in the same flow.
  • Every morning you want a summary of the day’s events.
  • An AI agent handles meeting requests and needs to check free slots and create events on its own.
  • An appointment is moved and you want to update the event and notify the guests.
  • An order is cancelled and you want to delete the follow-up meeting.

Configuration

You need a Google Calendar credential, which connects by signing in with your Google account. To create, change or delete events, the credential needs the Create, Update, Delete, Read access; with Read Only you can only look things up. 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 TypeOnly in Create and Get. Leave it on Selection to choose the calendar from the list. Default: Selection.
Calendar SelectionOnly in Create and Get. The calendar the event is created in or searched in. The list loads when you choose the credential and shows the calendars you can write to.
Event IDThe ID of the event. Required in Update and Delete. Optional in Get: if you fill it in, that event is returned directly.
SummaryOnly in Create and Update. The event title. Required in Create.
StartThe start date and time. In Get, the beginning of the period searched for events. It must be earlier than End.
EndThe end date and time. In Get, the end of the period searched for events.
Max ResultsOnly in Get. The maximum number of events returned. Default: 10.
Query FilterOnly in Get. Returns only the events that contain the text in their title, description, location, or the email of the guests or the organiser. If you leave it empty, all are returned.

Operations

OperationWhat it does
CreateCreates a new event and sends the invitation to the guests.
GetReturns the events of a calendar in the period between Start and End, sorted by date, or one event if you give its Event ID.
UpdateChanges an existing event and notifies the guests. Only the title, description, location and guests you fill in are changed; Start and End are always applied.
DeleteDeletes an event. If it is one occurrence of a recurring event, the whole series is deleted.

Advanced options

Only in Create and Update:

FieldWhat it does
DescriptionThe event description.
LocationWhere the event takes place.
AttendeesThe emails of the people invited. In Update, they replace the event’s previous guest list.
Create MeetAdds a Google Meet link to the event. Default: off.

Output

The Data output returns the events you worked with: their ID (id), title, start and end, guests, the link to open them in Google Calendar (htmlLink) and, if you turned on Create Meet, the meeting link. In Get you get one item per event. In Delete it returns a confirmation with the name of the deleted event.

You can connect the result to an email or messaging component to send the link, or to an AI agent so it uses it in its answer. The component can also be connected to an Agent as a tool, so the agent checks the calendar and creates events when it needs to. See Tool Mode.

Example

A clinic wants every appointment booked on its website to appear in the consultations calendar.

  1. The booking form reaches the flow with the patient’s name and email and the chosen date.
  2. Add Calendar Event with the Create operation and choose the Consultations calendar in Calendar Selection.
  3. In Summary put Appointment with followed by the patient’s name, and in Start and End the start and end time of the appointment.
  4. In the advanced options, put the patient’s email in Attendees so they receive the invitation.

Good practices

  • In Update, always write in Start and End the dates the event should have, even if they don’t change: otherwise the event moves to whatever dates those fields hold.
  • In Get, set Start and End to the period you care about, for example today. Only the events in that period are returned.
  • If you fill in Event ID in Get, the event is looked up in your primary calendar. For events in other calendars, use Query Filter with their title.
  • Guests receive an email from Google every time you create or change an event.