Back to Google Calendar

Connect Knoon AI with Google Calendar (Google) to automate AI workflows.

Search events in a specific calendar by extended properties, optionally constrained by time window and free-text query.

googleCalendarSearchEvents

BETA

Permissions

https://www.googleapis.com/auth/calendar.readonly

Optional permissions

There are no items to display.

Parameters

Name	Type	Description	Required
calendarId	file	ID of the calendar to search in (e.g. "primary" or a specific calendar ID).	Yes
start	mustache	Lower bound (inclusive) for event start time in RFC 3339/ISO 8601 format.	Yes
end	mustache	Upper bound (exclusive) for event end time in RFC 3339/ISO 8601 format.	Yes
maxResults	mustache	Maximum number of events to return (e.g. "10", "50").	No
query	mustache	Optional free-text search query applied to title, description, location, and participant names/emails.	No
privateExtendedProperty	map (mustache)	Optional map of private extended properties to filter by. Only events whose event.extendedProperties.private contain all key=value pairs will be returned (e.g. {"knoonContactExternalId": "{{data.contact.externalId}}"}).	No
sharedExtendedProperty	map (mustache)	Optional map of shared extended properties to filter by. Only events whose event.extendedProperties.shared contain all key=value pairs will be returned.	No

Returns

Name	Type	Description
status	string	DONE when events are returned.
events.start	string	Start date/time (RFC 3339/ISO 8601).
events.end	string	End date/time (RFC 3339/ISO 8601).
events.dayOfWeekLocal	string	Day of week in local time (e.g. Monday).
events.dayOfWeekUTC	string	Day of week in UTC (e.g. Monday).
events.sensitive.eventId	string	Unique identifier of the event.
events.sensitive.summary	string	Title of the event.
events.sensitive.description	string	Detailed description or notes for the event.
events.sensitive.location	string	Location of the event, if any.
events.sensitive.status	string	Event status (e.g. confirmed, tentative, cancelled).
events.confidential.htmlLink	string	Link to view the event in Google Calendar.