Skip to content
Back to help

Calendar sync

See your appointments anywhere

Connect two-way Google Calendar sync at /app/settings/calendar-sync so personal Google events block online booking slots automatically, or subscribe to a read-only feed in Google Calendar, Apple Calendar, or Outlook.

How it works

Goldenhour offers two ways to sync on the web:

  • Two-way sync (Google Calendar only): at /app/settings/calendar-sync, pushes new, rescheduled, and canceled goldenhour appointments to your Google Calendar and imports busy blocks back, from that calendar and from any other Google calendars you add, so clients cannot double-book over personal commitments.
  • Read-only calendar feed: a private subscription URL guarded by a long random token that any calendar app (Google, Apple, or Outlook) can poll.

Visit notes stay in goldenhour. The feed and the events pushed to Google Calendar say who is booked, for what and when, never the notes you write on a visit.

To copy your calendar feed URL: open /app/settings#calendar-feed and copy the feed URL. It looks like:

https://goldenhourhq.com/api/feeds/calendar/<long-token>

Per-platform recipes

Three platforms, three flavors

Google Calendar (two-way OAuth or read-only feed)

Refresh: Near real-time with two-way OAuth; about 24 hours with the read-only feed URL

  1. 01Recommended (two-way): on the web, open /app/settings/calendar-sync and click Connect Google Calendar.
  2. 02Choose whether personal busy events on your Google Calendar should automatically block online booking slots.
  3. 03Keep clients, beauty appointments, and personal plans in separate Google calendars? Add the others under 'Also block time with my other Google calendars': their events block online booking too, and your bookings still go to one calendar only.
  4. 04Read-only feed alternative: in Google Calendar on the web, find 'Other calendars', click +, choose 'From URL', and paste your calendar feed URL from /app/settings#calendar-feed.

Apple Calendar (read-only feed or iPhone app)

Refresh: 5 minutes to 1 day with a calendar subscription

  1. 01On iPhone: in the goldenhour app, open More, then Account, and turn on Calendar sync to add your appointments to your iPhone Calendar. It only adds appointments; events already on your phone do not block online booking.
  2. 02Read-only feed on Mac: File, then New Calendar Subscription, and paste your feed URL from /app/settings#calendar-feed.
  3. 03Read-only feed on iOS: Settings, then Calendar, then Accounts, then Add Account, then Other, then Add Subscribed Calendar.

Microsoft Outlook (web + desktop)

Refresh: Every ~3 hours (Outlook-controlled, not configurable)

  1. 01Open Outlook on the web.
  2. 02Calendar, then Add calendar, then Subscribe from web.
  3. 03Paste your goldenhour feed URL from /app/settings#calendar-feed, give it a name, and pick a color.
  4. 04Click Import. Desktop Outlook picks it up on next sync.

Refresh cadence

ICS feed lag vs two-way sync

If you use the read-only subscription URL, external calendar apps poll on their own schedule rather than updating instantly. For near real-time updates and two-way busy-block protection, connect Google Calendar directly in /app/settings/calendar-sync.

  • Google ICS subscription: ~24h (use Google OAuth sync for near real-time)
  • Apple ICS subscription: 5 min - 24h, chosen at subscribe time
  • Outlook ICS subscription: ~3h, no override

Security

The calendar feed URL contains a long random token (high entropy, functionally non-guessable). Don’t share the URL publicly. If a third party gains access (for example, you pasted it in a screenshot), rotate the token in /app/settings#calendar-feed. The old URL stops working immediately and you re-subscribe with the new URL.

Related: booking confirmations + .ics attachments