domainwidedelegation.comStart free

Use cases → Scheduling

Manage out-of-office events across multiple calendars

Centrally set and clear out-of-office events for users, ensuring accurate availability in busy multi-tenant environments.

Who it is forIT or operations teams coordinating absence schedules for large groups or multiple tenants.
APIsCalendar API
Typical scopescalendar

The problem

Manual out-of-office entry is error-prone, and users often forget to set or clear their status, leading to double bookings and missed handovers. Delegated automation allows controlled, consistent management but exposes quirks in Calendar API behaviour.

How it works

  1. Collect intended out-of-office periods from HR or a master schedule.
  2. For each user, use the Calendar API via a service account with domain-wide delegation to insert or update OOO events on their primary calendar.
  3. Set the event with 'transparency' as 'opaque', 'eventType' as 'outOfOffice', and mark as busy.
  4. On schedule changes, search for and update or remove the corresponding OOO event.
  5. Optionally notify the user of changes made on their behalf.

What changes

Absences are reliably reflected in calendars, preventing accidental scheduling and maintaining clarity for teams and external bookers.

The trap in this one. Calendar API's 'outOfOffice' eventType is only visible to first-party Workspace clients, but not all third-party tools respect it — some only see 'busy' status. Critically, if you insert multiple OOO events for overlapping periods, only the earliest event's decline message is sent; subsequent events for the same window are silently ignored for auto-decline. Testing with simulated overlaps is the only way to spot this.

Questions people ask

Can we set custom auto-replies with these events?

No, the out-of-office event only controls calendar busy status and auto-decline. For custom auto-replies, use the Gmail API to set a vacation responder.

How soon do changes propagate?

Calendar changes are near-instant in Google Calendar, but external systems (e.g. Outlook) may take several minutes to reflect the OOO status.

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 guide

Related 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.