Skip to main content

Calendar

Campbooks includes a two-way calendar that syncs with Google and Zoho — and it rides on the same connection as your mailbox. There's no separate calendar to connect: link a Google or Zoho email account and its calendar comes with it.

How it connects

Connecting a Google Workspace or Zoho mailbox requests calendar scopes on the same OAuth grant, so Campbooks auto-provisions that account's calendar and starts syncing. (Signing in with Google stays mail-only — calendar scopes are requested only when you connect a mailbox.)

Already connected before calendar existed? Reconnect the mailbox once to grant the calendar scope. And on a self-hosted instance, make sure the Google Calendar API is enabled on your Google Cloud project (see Connecting Email Accounts) — without it, the calendar list returns a permissions error.

Two-way sync

Changes flow both ways:

  • Events created in Google/Zoho appear in Campbooks.
  • Events you create, edit, delete, or RSVP to in Campbooks are pushed back to the provider.

Sync runs automatically — a fast incremental pull every minute and a fuller sweep every 15 minutes. Conflicts are resolved last-write-wins with an etag guard, and cancellations are tombstoned rather than silently dropped.

Self-hosting note. Google can push changes via webhooks, but that needs a public HTTPS URL it can reach. If your instance isn't publicly reachable, set DISABLE_CALENDAR_PUSH=1 — the minute-by-minute poll keeps everything in sync regardless. (Zoho always polls.)

Which calendars sync

When you connect an account, its primary calendar starts syncing automatically. Any other calendars on the account are off by default — turn the ones you want on under Settings → Calendars.

Views

Open /calendar and switch between four views:

ViewWhat it shows
AgendaA running list of upcoming events
DayAn hour-by-hour time grid with overlap columns and a now-line
WeekSeven days side by side
MonthThe classic month grid

Creating and editing events

Create, edit, and delete events right in Campbooks; changes sync to your provider. Each event can carry its own color (it inherits the calendar's color if you don't set one), and event chips automatically pick readable text so they stay legible on any background.

Email → event

Any email can become a calendar event. Campbooks reads the message to suggest a title, time, and location, and links the new event back to its source email. You can do this from the inbox, the Cmd+K command palette, the Scout assistant, or a workflow.

Sharing

Like mailboxes, calendars can be shared with others in your workspace with viewer, editor, or manager access — so a team can keep one shared schedule.

Reminders

Campbooks can also extract dated commitments from your email and documents into reminders, which you can confirm into calendar events. Reminders show up on the home feed, on the calendar, and at /reminders.