Skip to main content
POST
Create CoworkerGoogleCalendar
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-Create role.

Request Body

Required Fields

integer
required
ID of the Nexudus resource (room or desk) used as the Google Calendar push-notification watch target for this connection.
string
required
Display name of the connected Google Calendar.
string
required
Google push-notification channel ID used to receive calendar change notifications.
string
required
Google Calendar ID of the customer’s connected calendar (e.g. user@gmail.com or a secondary calendar ID).
string
required
Date and time when the Google push-notification channel subscription expires and must be renewed.
string
required
Google-assigned resource ID for the active push-notification watch channel.

Optional Fields

integer
ID of the customer who connected their Google Calendar.
string
Incremental sync token returned by the Google Calendar API, used to fetch only events changed since the last sync.

Code Examples

Response

200

integer
HTTP status code. 200 on success.
string
A human-readable message confirming the creation.
object
Contains the Id of the newly created record.
boolean
true if the coworkergooglecalendar was created successfully.
array
null on success.
Example Response

400

string
A summary of the validation error(s), in the format PropertyName: error message.
any
null on validation failure.
object[]
Array of validation errors.
boolean
false when the request fails validation.
Example Response