find_common_slots
Rank the best meeting times for the given participants, merging live Google/Microsoft calendar data, hand-marked availability and the heat-map sources. Each participant is filtered (Mon–Fri, waking hours) and scored in their OWN timezone; scores factor in buffer time around existing meetings and prefer sooner slots. Returns up to 8 slots: everyone-free slots first (allFree:true), then — only if there are too few — the best compromise slots (allFree:false) with a freeCount. Defaults to the next 14 days; the window may end at most 60 days from now (bad_window). Up to 50 participants; reading other people’s connected calendars is limited to 30 new addresses per hour and 50 per day (lookup_limit), and each read is shown to the calendar owner. Requires authentication.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Window end, unix ms. Default: now + 14 days. At most 60 days from now (400 bad_window). | |
| tz | No | Requester IANA zone, e.g. Europe/Warsaw — the fallback zone for participants whose own timezone is unknown, and the zone for the round-hour scoring bonus. | |
| from | No | Window start, unix ms. Default: now. | |
| durationMin | No | Meeting length. Default 30. | |
| participants | Yes | Participant emails, up to 50 (the authenticated user is the host and should be included). |