Back to Google Calendar
Google / Google Calendar
Search Events by Extended Properties
Search events in a specific calendar by extended properties, optionally constrained by time window and free-text query.
googleCalendarSearchEvents
Permissions
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. |
Install In Tools
See how to install an app in your tool
Follow the quick walkthrough below to add marketplace apps into your tool flow.
Step 01
Open your tool setup
Start from the tool workspace where you want to add a new app.
Step 02
Go to tools and create button
Open the Tools page, then click the Create button to start adding a new app.
Step 03
Choose Internal or External work
Choose Internal or External work, then select an app action.
Step 04
Select app to install to Knoon
Pick the app you want to install to Knoon and complete the setup flow.
Step 05
Success!
The app has been installed successfully and is ready to use in your workflow.
Power your business with Knoon's Agentic AI today.
Join businesses already resolving thousands of customer inquiries and sales leads with Knoon.