Calendars | TimeTuna Docs

Supported calendars

• Google Calendar: full two-way sync. TimeTuna reads free/busy data and creates events with Google Meet links.
• Microsoft 365 / Outlook: full two-way sync. TimeTuna creates events in your Outlook calendar and can attach Microsoft Teams links.
• Zoom: one-way. Used to generate Zoom meeting links on new bookings.
• iCal feeds: read-only. Paste an https:// ICS URL from any calendar service to block availability without granting OAuth access.

Connecting a calendar

On any booking page editor, open the Calendars tab and click Connect another calendar. Pick the provider, complete the OAuth flow, and the calendar appears in your list. Connections are per-account, so a calendar you connect once is available on every booking page you own.

Approve every permission

During Google or Microsoft sign-in, you will see checkboxes for read and write permissions. TimeTuna needs both, read to know when you are busy, write to create the new event. If you uncheck one, the calendar will not work.

Read vs. write

Per booking page you decide:

• Which calendars block availability (read). Any event on these calendars marks you unavailable.
• Which calendar holds new events (write). New bookings are created on this one calendar.

For example, you can have a personal calendar blocking availability without putting work meetings on it.

Choosing where new events land

In the Calendars tab, switch on every calendar you want checked for availability, then tap Create new events here on the one that should hold the bookings. The button turns dark and reads New events are created here. Only calendars you can write to offer it: read-only calendars and iCal feeds can block availability but cannot hold an event. Save the page for the change to take effect.

One calendar has to stay on

A booking page needs at least one enabled calendar, otherwise it has no way to tell a guest when you are free. If you want a page to stop using an account altogether, disconnect the account from your profile rather than switching every calendar off.

iCal feeds

To add a calendar without OAuth (a partner's Apple Calendar, a school timetable, a sports team schedule), grab its public .ics URL and paste it under Add iCal feed. TimeTuna re-fetches it periodically. iCal feeds are read-only, they can only block availability. Proton Calendar users: this is the supported way to connect, see the Proton Calendar guide for the full walkthrough.

Disconnecting

Disconnect a calendar from Settings → Connected providers. Existing bookings keep working, but new ones will not check that calendar's availability and will not write to it.

Tokens can expire

If you change your Google or Microsoft password, or revoke access from your provider's security page, TimeTuna loses its token and stops syncing. Reconnect from Connected providers. See OAuth disconnected.