Menu
MENU

How do I add my FareHarbor calendar to my mobile device or computer?

Last updated: March 25, 2022

You can subscribe to your availabilities using a calendar program on your iOS or Android phone or tablet, Google Calendar, or any app that supports the ICS format. This can be useful for keeping tabs on your bookings along with the rest of your schedule.

Booking information on a synced calendar includes the customer’s name, booking number, contact information, total amount paid and due, and any custom fields that were filled out.

Finding your subscription URL

To subscribe to your FareHarbor calendar, find and copy the unique subscription URL for your company (or the specific item you want to import), then add the URL to the calendar app or program of your choice.

Note: If your Dashboard has many items and bookings, there may be too much data for your calendar program to download the calendar of all items. In this case, you’ll want to subscribe to each item individually instead.

For a single item:

  1. Go to the Items section of your Dashboard and select an item.
  2. Go to Settings > Integrations > Subscribe to Calendar.
  3. Click the Create API Key button.

  4. Copy the the subscription URL with your API Key appended:

    Example of a single item subscription URL in FareHarbor:

For all items

  1. Go to your Dashboard Settings.

  2. From the Settings menu, go to Build > Integrations > Subscribe to Calendar.

    If you do not see the Build section, your permissions may need to be updated. Contact FareHarbor Support and we’ll be happy to help!

  3. Click the Create API Key button.

  4. Copy the the subscription URL as shown.

    Example of a subscription URL for all items in FareHarbor:

Note: You will only see the Create API Key button if you do not yet have an API key in your Dashboard.

Choose your operating system or preferred calendar app below for detailed steps on how to subscribe to your FareHarbor calendar.

iOS (iPhone, iPad or iPod Touch)

  1. Open the Settings app on your device, then tap Calendar.
  2. Tap Accounts > Add Account.
  3. Tap Other.
  4. Under Calendars, tap Add Subscribed Calendar.

  5. Paste your FareHarbor calendar subscription URL, then tap Next.

  6. Update the calendar description if desired (you do not need to change any other settings).

  7. Tap Save.

To automatically get the most recent booking information more often, update your fetch settings:

  1. Open the Settings app, then tap Calendar.
  2. Tap Fetch New Data under Accounts.
  3. Tap Every 15 minutes under Fetch.

Note: If you want to use the Google Calendar app on your device instead of the native iOS calendar app, please follow the instructions here.

macOS (MacBook, iMac, etc.)

  1. Open the Calendar app.
  2. Go to File > New Calendar Subscription.

  3. Paste your FareHarbor calendar subscription URL and click Subscribe.

    Subscribing to a calendar in the Calendar app

  4. Adjust your settings as desired. To automatically get the most recent booking information more often, select “Every 5 minutes” from the Auto-refresh dropdown. When done, click OK.

    Calendar app settings on OS X

Android

If you have an Android phone or tablet, we recommend using the Google Calendar app and adding your FareHarbor calendar by following the steps for Google calendar below.

If you don’t already have the Google Calendar app, you can download it here.

Google Calendar

Note: These steps must be completed on a computer; you won’t be able to subscribe to a new calendar from the Google Calendar mobile app.

On your computer:

  1. Follow the steps on how to obtain your subscription URL above, and copy the calendar URL to your clipboard.
  2. Open your Google Calendar in a web browser on your desktop.

  3. Click the + sign next to “Other calendars” on the lower-left corner of the page.

    "Add calendar" option in Google Calendar

    If you don’t see this option, you may be using an older version of Google Calendar. Look for the arrow next to “Other calendars” and select “Add by URL” instead.

  4. Select From URL.

    "From URL" option in Google Calendar

  5. Paste your FareHarbor calendar subscription URL and click Add Calendar. 9z Subscribing to a calendar in Google Calendar

  6. Open the Google Calendar app on your Android phone or tablet.
  7. Tap Settings.
  8. Scroll to the name of your primary calendar address. For example, if your email address is joe@mycompany.com, scroll to that calendar’s section.
  9. Tap Show more.
  10. Tap on the name of the calendar that you want to sync with FareHarbor, then tap on the toggle to the right of Sync to add this calendar to your phone or tablet.
  11. Tap the arrow to exit the Google Calendar settings.

Your FareHarbor calendar is now set up to sync with your Google Calendar app on your device!

Note: It may take up to 12 hours for changes in FareHarbor to appear in your Google Calendar. For more frequent updates, you may want to log into FareHarbor directly.

Outlook.com

Note: These steps are for the web version of Outlook. For the desktop version, see the section below.

  1. Click the Calendar icon at the bottom of the navigation pane.

    Calendar icon in Outlook

  2. From the toolbar, select Add calendar > From Internet.

    Adding a calendar in Outlook

  3. Paste your FareHarbor calendar subscription URL.

  4. Enter a name for the calendar, then click Save.

Outlook (desktop)

Note: These steps are for the desktop version of Outlook. For the web version, see the section above.

  1. Click the Open Calendar option at the top of your calendar view.

    Calendar icon in Outlook

  2. Select From Internet.

  3. Paste your FareHarbor calendar subscription URL.
  4. Enter a name for the calendar, then click Save.

If you’re having trouble adding your FareHarbor calendar in Outlook, try logging into Outlook.com in your web browser and following these steps instead.

Notes

  • Only availabilities with active bookings will be synced to your device.
  • Calendars sync bookings 7 days in the past and 42 days in the future.

Internal-only content. Don't copy and paste to anyone.

Additional questions and troubleshooting below.

Why do we only sync 42 days in the future?

Because we use a subscription approach for syncing calendars (instead of integrating with an API), sending data can take longer and eventually lead to timeouts if the user’s calendar is trying to sync a large number of bookings.

Currently we sync bookings 7 days in the past and 42 days in the future to avoid timeouts for larger companies with many availabilities. Although the limitation was primarily implemented for Google Calendar, the same cutoffs apply for other calendar apps as well.

Why don’t I see the ‘Create API Key’ button?

FH Admins have a different view than company users logged into their own Dashboard. Instead of the Create API Key button, you will see a subscription URL with API-KEY at the end:

How do I create a subscription URL for a company?

As a FH Admin, you can create subscription URLs per user. A user’s subscription URL can be used more than once, but you should double check whether or not the user has the permission “View only assigned bookings and availabilities” (if they do, the calendar subscription will only show availabilities that the user is assigned to).

To do this:

  1. Open the company’s Dashboard, and navigate to Settings > Users & Permissions.
  2. Select a user and go to the tab API Keys.
  3. Add an API key for the user.
  4. Copy the string in the “Key” column and paste it in a text editor.
  5. Go to the company’s Settings > Integrations > Subscribe to calendar.
  6. When adding the subscription URL for the company, copy the subscription URL provided and replace API-KEY with the string you copied in Step 4.

Why can’t the client see the ‘Integrations’ section?

Currently, if a user’s permission group doesn’t allow them to see any other sections under Settings > Build, we hide the entire section to the user. This means it’s possible for a user to not be able to see the Integrations section in the Settings sidebar.

A report has been filed to update the logic around this, but in the meantime, you can create a workaround by giving the permission group access to any other part of the build section, such as “View gift cards” (these settings are located in the Setup section of the permission group).

Once their permission group has been updated, the user should then be able to view only the Gift Cards and Integrations sections:

Related Pages

Want to submit an update to this page?

Submit a Help Page Request