Use cases → Scheduling
Import public holidays to all shared calendars
Bulk-load national or regional holiday events into every team or departmental shared calendar using a delegated service account.
| Who it is for | Workspace admins managing shared calendars for distributed or international teams. |
|---|---|
| APIs | Calendar API |
| Typical scopes | calendar |
The problem
Manually adding public holidays to each shared calendar is repetitive and error-prone, especially when calendar ownership is unclear or distributed. Missed holidays cause conflicts and confusion in shared team schedules.
How it works
- Identify all shared calendars in scope by querying the Calendar API with delegated access.
- Fetch or generate the correct holiday event set for each target region.
- Insert holiday events into each shared calendar, ensuring unique event IDs to avoid accidental duplication.
- Record which calendars were updated and when, for audit and re-run purposes.
What changes
Every shared calendar reflects the correct public holidays, reducing booking errors and giving staff clarity on availability.
Questions people ask
Can this update existing holidays if the dates change?
Yes, if you use stable event IDs when inserting. Updates will overwrite the old event; otherwise, it will create new duplicates.
Does this work for secondary or resource calendars?
Yes, as long as the service account has access via domain-wide delegation and the calendar is not hidden from the API.
Want this built?
This is a pattern we run in production. We will set up the delegation and build this on top of it — $500 per hour, most of it working the same day.
Talk to us Or read the setup guideRelated use cases
Build a real picture of team availability
Read calendars across the domain to answer who is free, who is overloaded and where the week actually went.
Turn a finished meeting into follow-up automatically
Detect that a meeting happened, pull the notes, and draft the follow-up before anyone opens their laptop.
Turn a booking into a record everywhere it matters
When a meeting is booked, create the record, the folder and the confirmation in one pass.