Support
Documentation

Synchronize with other calendars

Please note that the features described on this page are only available to subscribers. You can try them out for a week by clicking the button “Start free trial” on the “Synchronization” page.

SuperSaaS offers different ways to connect your appointment schedules to other online calendar programs. You can let your SuperSaaS schedule depend on availability in your Google or Outlook Calendar. And you can publish appointment information in your SuperSaaS schedule to another calendar program, such as Apple Calendar or Outlook.

Let your SuperSaaS availability depend on a Google Calendar
Show your SuperSaaS bookings in an external calendar

Let availability in SuperSaaS depend on your Google or Outlook Calendar

SuperSaaS is able to connect directly to Google Calendar and use its free/busy information to determine your availability in SuperSaaS. You can also let the availability of your SuperSaaS calendars depend on your availability in a web based Outlook calendar. If you are using the desktop version of Outlook you would first need to sync that with Outlook.com.

When you link a Google or Outlook Calendar to a SuperSaaS schedule, appointments in your Google or Outlook Calendar will be marked as unavailable in your SuperSaaS schedule.

This way, customers can only book when both your personal calendar and your general opening hours allow them to. Only the free/busy information will be synchronized, so your customers will not see any of the details from your personal appointments.

Using this type of synchronization can also be useful if you want to define complex opening hours. You can create a complex pattern of repeating appointments in Google or Outlook Calendar that leave your desired opening hours available.

To synchronize your free/busy information:

  1. Go to Supervise > Synchronize on the schedule that you want to set the availability for
  2. At the “Connect to” heading choose “Google Calendar” or “Microsoft Outlook”
  3. Google or Microsoft may now ask you to log in and will show a confirmation screen
  4. Once the authentication screen closes you should see a list of calendars in your account
  5. Select one and save the page

Once this is set up, the SuperSaaS system will regularly check your Google or Outlook Calendar for changes. The frequency with which the availability information from Google or Outlook is updated depends on how often your schedule is accessed.

Whenever someone uses your schedule, the system evaluates whether its copy of your information is older than 15 minutes and if it is, it will update the information. This update process can take a few seconds and it may take a second page refresh for the updated information to display. This should not be a problem for users, since they always use more than one page before they can make a booking. Updates are retrieved up to 5 months into the future, so you may want to ensure your users cannot book further in advance.

If you want to put an appointment in your Outlook or Google Calendar that you don’t want to show up as unavailable in SuperSaaS, you can click Edit event details in Google Calendar and select the option Show me as: Available. If you want to still be able to make appointments yourself during busy times on your Outlook or Google Calendar, then check the Allow the administrator to ignore time constraints option on the opening hours tab.

Ensure time zones are configured correctly

Ensure the time zone is set correctly, both in Google Calendar or Outlook and in SuperSaaS. Time zones do not have to be the same on both calendars, but times will be translated as appropriate if the time zones differ, so you should make sure that such a translation happens intentionally.

Let availability in SuperSaaS depend on someone else’s Google Calendar

Sometimes it can be useful to read the availability of a Google Calendar to which you do not have full access. For example, a freelance employee may want to share his availability to perform a service for you. However, you would not want to ask full access to his Google account to achieve this. In that case he can make only the availability information part of his Google Calendar public:

  1. In Google Calendar, the person who wants to share his availability can hover over the name of the calendar with the mouse and click the three dots that appear.
    Google Calendar
  2. Now click Settings and Sharing
    Click on share
  3. Choose Access Permissions in the menu on the left. Tick the checkbox Make Available to Public and select See only free/busy (hide details) option.
    Google Calendar access permissions
  4. Scroll down to the Integrate Calendar section and copy the calendar ID as shown below. If there is only one Google Calendar, the ID is usually equal to the email address. The employee can then share this ID with you.
    Google Calendar ID
  5. On your SuperSaaS dashboard, navigate to Supervise > Synchronize. Here you can click “Public Google Calendar” and then fill out the calendar ID. The software will verify the connection upon clicking Save changes. Note that if the access settings in the previous step were not set up correctly, the Google server will somewhat confusingly report “Not found”.

Publish SuperSaaS appointments to Google Calendar

You can configure publishing on the page Supervise > Synchronize. Under the heading “Publish to Google Calendar”, click the button “Connect to: Google Calendar”. Google will ask you to log in and once you return you can select one of your Google Calendars to add the appointments to. From then on new appointments will be added to your Google Calendar, and existing appointments will be updated. Note that publishing works one way, so changing the appointment in Google Calendar will not change it in SuperSaaS.

It’s a good idea to create a new Google Calendar before you set this up. That way the appointments coming from SuperSaaS will have a different color and you can easily keep them apart from your own appointments. Having them in a separate calendar also makes it easy to delete all of them in one go, should that be needed.

Only new appointments, starting from the moment you set up the sync, will be transferred. If you would like to transfer existing appointments then you can download those via Supervise > Download. Select the option “ics – iCalendar” from the dropdown menu and then upload the resulting file to Google Calendar. However, appointments imported this way do not get updated if something is changed later. You can use the method described in the next section to import appointments in a way that propagates future updates as well, but that works more slowly.

Google Calendar was designed for personal appointments, which means it does not always match the concept of a booking in SuperSaaS. Specifically, in a “capacity” type schedule with group bookings, Google Calendar will display the slots that contain the bookings, but it will not display the bookings inside them.

Publish a SuperSaaS Schedule to another calendar program

You can publish your schedule to any calendar program that can subscribe to an industry standard iCalendar feed, such as Microsoft Outlook or Apple’s Calendar. The iCalendar link is one way; when you change something in your SuperSaaS schedule, it will be reflected in, for example, your Outlook calendar once it synchronized. The appointments cannot be edited in Outlook.

You can also use the webcal link to show your bookings on the calendar of your mobile phone. However, the mobile version of our website is generally a better choice as it lets you edit appointments too.

These steps explain how to set up a webcal link. In this example we use Apple Calendar, but it will look very similar in other calendar programs:

  1. You will first need the webcal link. You can find this in your SuperSaaS account via Supervise > Synchronize
  2. In Apple Calendar click “File” and select “New Calendar Subscription…”.
  3. A pop-up will appear where you can enter the link. After you select “Subscribe” the calendar SuperSaaS calendar should become visible.
Choose: New Calendar Subscription…
Enter address

On a subscribed calendar, the data is kept separate from the other appointments on your calendar. It is not actually merged, so you can easily delete it again without affecting your other appointments.

If instead you want to merge the appointments from your SuperSaaS calendar with those of your calendar program, then you can download them via Supervise > Download and upload them into your calendar program. In that case, however, the appointments can no longer be automatically updated. A middle ground is to have the SuperSaaS system automatically send you confirmation emails with a small iCal attachment each time an appointment gets made. This allows you to add the appointments to your calendar with one click. You can add an iCal attachment by including the magic word $ical to your email confirmations.

The frequency with which the data is updated depends on the calendar program used, not SuperSaaS. The iCalendar protocol is quite inefficient as it requires the transfer of all calendar data for each update. This makes that most calendar programs choose not to update too frequently. Also, the iCalendar protocol only allows for a limited number of data fields to be sent across. This means that none of the custom fields you have defined in SuperSaaS will be transferred.

Note that the frequency with which Google Calendar updates the information is not under our control and can take several hours. There is a quicker way to sync to Google Calendar outlined above. Updates to most other programs, such as Microsoft Outlook, should take about half an hour when default settings are used.

The iCalendar protocol does not provide authorization measures. If you are concerned people might find out your webcal link and use it without your knowledge, you can block it. On the Configure > Access tab, near the bottom of the screen you can select Block access with calendar programs. After selecting this option synchronization via iCalendar will be disabled.