A CoworkerGoogleCalendar record represents a Google Calendar account connected to a customer’s Nexudus account.
These records are created automatically when a customer connects their own Google Calendar from the Members Portal or the Nexudus app. Once connected, customers can book resources at a location directly from their Google Calendar.
Each record stores the Google push-notification subscription details (SubscriptionId, WatchResourceId, SubscriptionExpireDate) used to keep the calendar in sync, as well as an EventSyncToken for incremental Google Calendar API event queries.
For more information, see the Google Calendar (Customer) help article.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.
The authenticated user must be a full unrestricted administrator or have the CoworkerGoogleCalendar-List role.
Query Parameters
The page number to retrieve.
The number of records per page.
The property name to sort results by (e.g. Name, CreatedOn).
Sort direction. 1 for ascending, -1 for descending.
Filters
CoworkerGoogleCalendar_Resource
Filter by iD of the Nexudus resource (room or desk) used as the Google Calendar push-notification watch target for this connection.
CoworkerGoogleCalendar_Coworker
Filter by iD of the customer who connected their Google Calendar.
CoworkerGoogleCalendar_Coworker_FullName
Filter by full name of the customer who connected their Google Calendar.
CoworkerGoogleCalendar_Name
Filter by display name of the connected Google Calendar.
CoworkerGoogleCalendar_SubscriptionId
Filter by google push-notification channel ID used to receive calendar change notifications.
CoworkerGoogleCalendar_CalendarId
Filter by google Calendar ID of the customer’s connected calendar (e.g. user@gmail.com or a secondary calendar ID).
CoworkerGoogleCalendar_SubscriptionExpireDate
Filter by date and time when the Google push-notification channel subscription expires and must be renewed.
CoworkerGoogleCalendar_WatchResourceId
Filter by google-assigned resource ID for the active push-notification watch channel.
CoworkerGoogleCalendar_EventSyncToken
Filter by incremental sync token returned by the Google Calendar API, used to fetch only events changed since the last sync.
Range Filters
from_CoworkerGoogleCalendar_SubscriptionExpireDate
Filter by date and time when the Google push-notification channel subscription expires and must be renewed greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
to_CoworkerGoogleCalendar_SubscriptionExpireDate
Filter by date and time when the Google push-notification channel subscription expires and must be renewed less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
from_CoworkerGoogleCalendar_CreatedOn
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
to_CoworkerGoogleCalendar_CreatedOn
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
from_CoworkerGoogleCalendar_UpdatedOn
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
to_CoworkerGoogleCalendar_UpdatedOn
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.
Code Examples
Simple listing
curl -X GET \
"https://spaces.nexudus.com/api/spaces/coworkergooglecalendars?page=1&size=15&orderBy=Name&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Filtering by Name
curl -X GET \
"https://spaces.nexudus.com/api/spaces/coworkergooglecalendars?CoworkerGoogleCalendar_Name=example-value&orderBy=Name&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Range filters
curl -X GET \
"https://spaces.nexudus.com/api/spaces/coworkergooglecalendars?from_CoworkerGoogleCalendar_UpdatedOn=2025-01-01T00:00&to_CoworkerGoogleCalendar_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=-1" \
-H "Authorization: Bearer YOUR_TOKEN"
Response
200
The list of CoworkerGoogleCalendar records matching the query. See the Get one CoworkerGoogleCalendar endpoint for the full list of properties returned for each record.
Number of records per page.
The field used for sorting.
The sort direction (1 = ascending, -1 = descending).
Index of the first item on the current page.
Index of the last item on the current page.
Total number of matching records across all pages.
Whether there is a next page of results.
Whether there is a previous page of results.
{
"Records": [
{
"ResourceId": 0,
"CoworkerId": null,
"CoworkerFullName": null,
"Name": "",
"SubscriptionId": "",
"CalendarId": "",
"SubscriptionExpireDate": "2025-01-15T10:30:00Z",
"WatchResourceId": "",
"EventSyncToken": null,
"Id": 87654321,
"UpdatedOn": "2025-01-15T10:30:00Z",
"CreatedOn": "2025-01-10T08:00:00Z",
"UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"UpdatedBy": "admin@example.com",
"IsNew": false,
"SystemId": null,
"ToStringText": "CoworkerGoogleCalendar Example",
"LocalizationDetails": null,
"CustomFields": null
}
],
"CurrentPageSize": 15,
"CurrentPage": 1,
"CurrentOrderField": "Name",
"CurrentSortDirection": 1,
"FirstItem": 1,
"HasNextPage": false,
"HasPreviousPage": false,
"LastItem": 1,
"PageNumber": 1,
"PageSize": 15,
"TotalItems": 1,
"TotalPages": 1
}