> ## Documentation Index
> Fetch the complete documentation index at: https://docs.servicebooked.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# ICS feed

> A read-only feed of your ServiceBooked appointments — subscribe from Apple Calendar, Outlook, Google Calendar, or anywhere.

ServiceBooked exposes an **ICS (iCal) feed** of your appointments at a private, token-protected URL. Subscribe to it from any calendar app and your appointments show up alongside your other events — read-only.

This is useful when:

* You don't want to give us full read/write access to your real calendar.
* You want appointments visible in a calendar that ServiceBooked doesn't natively integrate with (Apple Calendar, Notion Calendar, Fantastical).
* You want a backup view in case our dashboard's Calendar isn't where you check first.

## Get your subscribe URL

<Steps>
  <Step title="Open Settings → Integrations">
    Find the **ICS feed** section.
  </Step>

  <Step title="Generate the URL">
    If you don't have one yet, click **Generate ICS feed**. We'll create a long random URL that's unique to your organization.
  </Step>

  <Step title="Copy the URL">
    Copy the full URL. Looks like `https://app.servicebooked.ca/api/ics/<long-random-token>`.
  </Step>
</Steps>

## Subscribe in each app

### Apple Calendar (macOS / iOS)

* **Mac**: Calendar → File → New Calendar Subscription → paste URL → set refresh frequency.
* **iPhone/iPad**: Settings → Calendar → Accounts → Add Account → Other → Add Subscribed Calendar → paste URL.

### Google Calendar

* Click the **+** next to "Other calendars" in the left sidebar → **From URL** → paste.
* Note: Google Calendar subscriptions refresh slowly (often once per day), so use this only as a secondary view, not your primary booking calendar.

### Outlook

* Outlook (web): Calendar → Add calendar → Subscribe from web → paste.
* Outlook (desktop): File → Account Settings → Internet Calendars → New → paste.

### Other apps

Most calendar apps support "Add by URL" or "Subscribe to ICS". Look in the calendar's import / add menu.

## What's in the feed

Every confirmed appointment in ServiceBooked, with:

* Customer name and contact info
* Service type
* Time and duration
* Location (if set)
* A link back to the contact's page in your dashboard

## Privacy

The URL contains a long random token — guessing it isn't feasible. Anyone who has the URL can read your feed, so don't share it publicly.

## Rotating the URL

If you accidentally shared the URL or it leaked, rotate it from **Settings → Integrations → ICS feed → Rotate URL**. The old URL stops working immediately. Re-subscribe in your calendar app with the new URL.

Heads up: rotating breaks every existing subscription. Anyone subscribed (including you on multiple devices) needs to re-subscribe.

## Refresh delay

We update the feed in real-time on our side. The delay you see in your calendar app is whatever refresh interval the app uses — Google Calendar is often 24h, Apple Calendar can be tuned to 5 min, Outlook varies.

For real-time visibility, the in-dashboard **Calendar** view is always live. The ICS feed is a secondary view.

## Next

You're done with calendar setup. Next:

<Card title="Contacts & CRM" icon="users" href="/contacts/overview">
  Where all your leads and customers live.
</Card>