What's included
- Google Directory sync, import employees from Google Admin
- Google Calendar sync, approved leave appears in a shared team calendar
- Single Sign-On (SSO), employees sign in with Google
- Google Chat notifications, approval messages sent via Google Chat (optional)
Setup
You need Google Workspace Super Admin access to complete the directory sync and calendar integration.
Create a service account in Google Cloud
Go to the Google Cloud Console → IAM & Admin → Service Accounts → Create Service Account.
Name it timeleaf-sync, download the JSON key file.
Enable APIs
In Google Cloud Console → APIs & Services → Library, enable:
- Admin SDK API (for directory sync)
- Google Calendar API (for calendar sync)
- Google Chat API (for Chat notifications, optional)
Grant domain-wide delegation
In Google Admin → Security → API controls → Domain-wide delegation → Add new.
Enter your service account's Client ID and the following OAuth scopes:
https://www.googleapis.com/auth/admin.directory.user.readonlyhttps://www.googleapis.com/auth/calendar
Connect in TimeLeaf
Go to Settings → Integrations → Google Workspace and upload your service account JSON key. Set the Admin email. This is the Google Workspace admin account TimeLeaf will impersonate for directory reads.
Click Test connection then Sync now.
Calendar sync
TimeLeaf creates a shared Google Calendar called TimeLeaf - Time Off in your Workspace. Approved leave is added as all-day events. All employees in the organisation can subscribe to this calendar.
Leave events are updated if a request is cancelled or modified after approval.