domainwidedelegation.comStart free

Use cases → Scheduling

Broadcast real-time calendar availability across systems

Use a delegated service account to surface users’ up-to-date free/busy status to other platforms or internal dashboards.

Who it is forEngineering teams building coordination tools or integrations needing live availability for many users.
APIsCalendar API
Typical scopescalendar.readonly

The problem

Teams want to show up-to-date calendar availability in external tools or dashboards, but polling individual calendars at scale is error-prone, slow, and can quickly hit quota or rate limits.

How it works

  1. Delegate a service account with calendar.readonly to impersonate users.
  2. Query users’ free/busy windows using the Calendar API’s freeBusy.query endpoint.
  3. Cache results briefly to avoid excessive API calls.
  4. Broadcast the aggregated availability to the destination system in near real-time.

What changes

Consumers can see accurate availability status for many users with minimal delay, supporting coordination and automation.

The trap in this one. The freeBusy.query endpoint is eventually consistent: rapid changes to events (e.g., a just-created meeting) may not be reflected for several seconds or longer. If you poll too aggressively, you risk rate limiting, but if you cache too long, you show stale data. In practice, you must balance polling frequency, cache invalidation, and error handling to avoid silent gaps or misleading availability.

Questions people ask

How close to real-time is possible?

Expect a delay of several seconds to a minute due to API consistency and event propagation. There is no supported push mechanism for free/busy data.

Can I use push notifications for free/busy?

No, the Calendar API’s push notifications do not support free/busy directly. You must poll and handle consistency gaps.

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.