Google Calendar integration guide
NexaSquared can sync approved employee leave and staff unavailability into a dedicated Google Calendar called NexaSquared Leave Calendar. Google Calendar is a display destination only; NexaSquared remains the source of truth.
What NexaSquared syncs
- Approved employee leave and staff unavailability.
- All-day events for full-day leave.
- Timed events for morning or afternoon half-day leave.
- Updates when approved leave dates or display settings change in NexaSquared.
- Removal or cancellation when approved leave is cancelled in NexaSquared.
Why Calendar permission is required
NexaSquared requests the narrow Google Calendar app-created scope so it can create and manage its own dedicated NexaSquared calendar and NexaSquared-created events. NexaSquared does not request Gmail, Google Drive, Google Contacts or Google Admin SDK access.
What data is not synced
- Pending or declined leave.
- Sick leave reasons or private leave notes by default.
- HR notes, approval comments, payroll data, medical details or sensitive employee records.
- Edits made in Google Calendar never update NexaSquared in Phase 1.
How to connect, disconnect and revoke access
- A Company Admin opens Settings → Calendar integrations.
- They choose Connect Google Calendar and approve the NexaSquared Google consent screen.
- NexaSquared creates the dedicated leave calendar and stores OAuth tokens encrypted at rest.
- Admins can disconnect from the same page at any time.
- Admins can also revoke NexaSquared access from their Google Account security settings.
Who can manage the integration
Only authorised Company Admins can connect, disconnect, test, retry failed syncs or change calendar sync settings. Platform Owners can configure OAuth credentials and view readiness/status information, but token values are never shown.
How events appear
The default event title is Employee Name - Unavailable. The default description is Managed by NexaSquared. Showing the leave type is optional and disabled by default.