Calendar
Research
Calendar engineering guide

How to read Google and Microsoft calendar API documentation

Provider documentation becomes easier to use when you map every feature to five concerns: identity, permissions, resource shape, incremental synchronization, and notification renewal.

Research surface only. This guide documents architecture and evaluation criteria; it does not describe a released DewEngine connector.
01
Google Calendar

Follow events, sync tokens, and watch channels together

Google Calendar uses calendar and event resources, nextSyncToken for incremental collection changes, and HTTPS watch channels that announce a resource changed without including the changed event body.

  • CalendarList and Events references
  • OAuth scope table
  • Incremental synchronization guide
  • Push notification and recurrence guides
02
Microsoft Graph

Separate event APIs, calendar view delta, and subscriptions

Graph documents calendar and event operations alongside delegated and application permissions. Calendar-view delta tracks a chosen date range, while change-notification subscriptions have their own validation and renewal lifecycle.

03
Cross-provider map

Do not assume matching names mean matching behavior

Compare all-day end dates, time-zone identifiers, recurring masters and instances, cancellation representation, attendee responses, conference data, resource calendars, ETags or change keys, and event ID stability.

04
Implementation record

Turn documentation into a tested capability matrix

For every promised action, record the provider endpoint, access mode, least permission, supported account types, limits, error cases, and real-account test evidence. Recheck official docs when provider behavior changes.

  • Read, create, update, cancel
  • Free/busy and resources
  • Recurring event operations
  • Sync, webhook, expiry, and recovery
Questions

Before you build.

Is there one standards-based calendar API equivalent to IMAP?+

No single protocol gives the same broad, modern SaaS integration surface across Google and Microsoft. Their official APIs remain distinct and require provider-specific adapters.

Can provider documentation prove a connector works?+

No. It defines intended behavior. Production readiness still requires conformance tests against every account type and operation the product claims to support.

Can I use DewEngine's calendar connectors today?+

Not as released connectors. Google Calendar has one feature-flagged development method, calendar.event.create, plus list/get for DewEngine-confirmed creates and the resulting canonical creation event. Provider calendar reads and sync, update/delete, availability, recurrence, watches, and Microsoft Graph Calendar remain planned. The implemented slice has only local fake-provider evidence, not real-account or production conformance.

Build with us

Does this match the workflow your users need?

DewEngine is in development. Real use cases decide what ships first.

Share your use case