Skip to content

Availability

  • Availability

  • Setting the organization's working hours

  • Choosing which schedule applies to the whole organization

  • Recording organization closures

  • Understanding where non-working days count

  • Connecting a host's Google, Apple or Outlook calendar

  • Checking that an external calendar is blocking time slots

  • Understanding which time slots are offered to people booking

  • What people booking from the website see

  • How people who booked move or cancel their booking

All modules

Connecting a host's Google, Apple or Outlook calendar

Availability · 6 of 10 · 5 min read

Connect the calendar a host already uses — for example Google Calendar, Apple Calendar or Outlook — to their profile. This prevents anyone booking from choosing times when the host has other commitments. For example, you can connect Mario Rossi's work calendar; he carries out the Wedding site visit.

How an external calendar works

The external calendar is read in read-only mode. Its events block the host's bookable time slots. Nothing is ever written to the connected calendar.

The connection uses the calendar's secret address, not the account credentials. Only https addresses are accepted.

The calendar only blocks time slots if you connect it to a person assigned to an appointment type. In the example, the people are Giulia Verdi and Mario Rossi.

  • If the host records their commitments in an external calendar, connect that calendar to avoid receiving bookings at those times.
  • If the host uses multiple calendars — for example a work one and a personal one — connect them one at a time, each with its own name.
  • If you only want to see Archimedes appointments and deadlines in Google, Apple or Outlook, do not connect an external calendar: use the My agenda in Google/Apple/Outlook tab.

Note: if no one is yet assigned to an appointment type, the section displays the message «There is nobody to connect a calendar for yet. Only people assigned to an appointment type have booking slots an external calendar could protect — assign a host to an appointment type first.»

Finding the calendar's secret address

Before connecting the calendar, copy its secret address from the service that hosts it. Below the connection form there are instructions for Google Calendar, Outlook on the web and Apple Calendar (iCloud).

Google Calendar:

  1. Open Google Calendar from a computer, click the gear icon at the top right, then «Settings».
  2. In the left-hand column, under «Settings for my calendars», click the host's calendar.
  3. Click «Integrate calendar» and copy the link under «Secret address in iCal format» using the copy button next to it.
  4. Paste it into the Secret calendar address field.

Important: do not use «Public address in iCal format», which only works if the calendar is public. Do not use «Export calendar» either: it downloads a file instead of providing an address. With a work or school account, the secret address may be missing because the administrator has disabled it: ask them.

Outlook on the web:

  1. Open Settings (the gear icon) › «Calendar» › «Shared calendars».
  2. Under «Publish a calendar» choose the calendar and «Can view all details», then click «Publish».
  3. Copy the ICS link that appears and paste it into the Secret calendar address field.

Apple Calendar (iCloud):

  1. In the Calendar app on iPhone or iPad, tap «Calendars», then the info button (i) next to the iCloud calendar.
  2. Turn on «Public Calendar».
  3. Tap «Share Link», copy the link and paste it into the Secret calendar address field.

Important: treat this address like a password: anyone who has it can read the entire calendar. Archimedes stores it encrypted and never shows it again.

Connecting the calendar

The connection form is in the External calendars section, below the availability hours.

  1. Open Appointments › Settings › Booking setup and the Availability tab.
  2. Scroll to the External calendars section.
  3. Fill in the form fields.
  4. Click Connect calendar.

External calendars section with the connection form filled in for Mario Rossi

The form fields:

  • Host: the host to whom the calendar belongs. The list only shows people assigned to an appointment type, for example Giulia Verdi and Mario Rossi.
  • Name: the name by which the calendar appears in the section, for example Google personale. Used to distinguish multiple calendars belonging to the same person.
  • Secret calendar address: the address copied from Google, Outlook or Apple. For Google it takes the form https://calendar.google.com/calendar/ical/…/basic.ics.

After connecting

After clicking Connect calendar, the message «Calendar connected. Checking it now…» appears. The calendar is then read and its events remove time slots from the booking page.

Connected calendars update automatically approximately every 15 minutes. The calendar appears in the section's list with its status and controls: Checking that an external calendar is blocking time slots explains what each status means.

Note: with Show on the agenda enabled, the calendar's events also appear in the host's agenda.

Messages during connection

If the address or person are not valid, the calendar is not connected and a message appears.

  • «Only https addresses are accepted. Copy the secret address exactly as your provider gives it.»: the address does not start with https. Copy it again from the service without modifying it.
  • «Remove the username and password from the address.»: the address contains credentials. Remove them and try again.
  • «That calendar is already connected to this host.»: the same address is already connected to the chosen person.
  • «This host already has the maximum number of connected calendars.»: disconnect one of the person's calendars before connecting another.

← Previous

Understanding where non-working days count

Next →

Checking that an external calendar is blocking time slots

On this page

Book a demo

See it on your company, not on a slide deck.

In 30 minutes we map the software you use today.We show you how much work and how much margin Archimedes gives back.

Show me on my business →
No commitmentReply within one working day