DayBack and Global Holidays Integration

Published on 11th of May 2020 by Julian

DayBack is a popular calendar and scheduling app that helps you make time for what's most important. One of its best features is that it allows you to manage the schedules of multiple resources where a resource could be a team member or a physical asset such as a room or truck. One thing it does lack however, is the concept of public and federal holidays. This is important if you're attempting to plan around the availability of multiple resources in different geographical locations across the world.

While you could create events for representing holidays, it would become unmanageable as you onboarded more resources across more locations. Thankfully, it is easy to import a list of holidays for specific locations by leveraging DayBack's support for Google Calendar integration and using it as a gateway to Holiday Oracle. This post will show you how it is done.

Before we get started you'll need the following

We will be utilising Holiday Oracle's API support for producing iCal URLs that can be consumed by third party applications.

Produce iCal URLs

You'll want to produce iCals URLs for each location where you would like to import holidays into DayBack. This previous blog post explains how to produce iCal enabled URLs via either the Holiday Oracle API or web console.

There's no need to download the iCal file, however you will need to copy the URLs that are given to you by the Holiday Oracle system.

Add iCals to your Google Calendar

Log in to your Google account and click on the plus sign near the "Other calendars" heading in the left hand pane.

Subscribe to an iCal feed
Adding new calendars to your Google Calendar account

You will be creating a Calendar from the URLs that you copied in step one, so go ahead and click on the "From URL" option at which point you will be presented with a form where you can paste in the iCal URL provided to you by Holiday Oracle.

Subscribe to an iCal feed
Repeat this step for each location (i.e. each iCal URL)

Note that there's no need to make the calendar publicly accessible. Once you have entered in the URL and clicked on the "Add Calendar" button, you should see the new calendar under the "Other calendars" heading in your Google Calendar and your calendar should now be populated with holidays from Holiday Oracle.

Imported Holiday Oracle holiday dates
In this example, a new calendar for California in the United States now appears
Import your calendars into DayBack

If you haven't done so already, you'll need to give DayBack access to your Google Calendar. There should be an authorise button under the Google Calendar heading.

Authorise DayBack to acess your Google Calendar
Authorise DayBack to get access to your Google Calendar
Authorise DayBack to acess your Google Calendar
Authorise DayBack to get access to your Google Calendar

When you've gone through the authorisation process your Holiday Oracle Calendars should appear in your DayBack calendar and schedule.

DayBack Calendar with holidays
The Californian holidays calendar now appears in DayBack

Once your holiday calendar appears in your Dayback calendar you can then manage it's settings, such as assigning it to a default resource. This is really powerful as it allows you to do things such as:

  • Create a new resource for your Californian team (eg. CA Team) and have all holidays that occur in California populate DayBack and automatically be assigned to that resource. The rest of your team can instantly see that your Californian team will be unavailable on Veteran's Day for example (11th of November).
  • Assign the Californian holidays to any team members or resources located in California (such as rooms, facilities or equipment) so that they aren't scheduled on holidays.

You can repeat this for any locations where your team operates and therefore would need holiday date data. And because Holiday Oracle supports 167 countries and 318 subdivisions there's a good chance that we would have dates for the locations that you are after. It's important that your calendars are up to date, however holidays change frequently. Best of all, you would only need to perform these steps once as the dates returned by Holiday Oracle are automatically updated for you and then synced to your DayBack account.