Show your calendar in other apps

Subscribe to one of your AllMailHub calendars in another app using a secret, read-only link. AllMailHub serves the current data when fetched; the subscribing app decides when to fetch it.

Create a link – available from Pro

  1. Open calendar settings and choose “Show in other apps” for a calendar you own. Only its owner manages links. The private mail-invitation calendar is excluded.
  2. Choose “New link”, a name for your own reference and a detail level. Each calendar supports up to five links.
  3. Copy the HTTPS or webcal:// link. The full link appears only immediately after creation or reset. Afterwards, only its last four characters are shown.
  • Anyone who knows the link can fetch the shared events. Give it only to apps, not to people, and do not publish it. Other apps may store it in their configuration or debug logs.

Detail levels and private events

“Can view when I’m busy” shows times and “Busy”. “Can view titles and locations” is the default. “Can view all details” adds descriptions, links and categories. Structured attendees, organizers, reminders and attachments are never included.

All private events, including your own, appear only as “Busy”. Private events marked as free are omitted. A private exception makes the entire series anonymous as a precaution.

The time window selects whole objects

Selection runs from local midnight today minus 30 days to local midnight today plus 365 days (exclusive), in the calendar’s time zone. An overlapping occurrence selects its entire object.

Recurring series are delivered without truncation, including all occurrences and exceptions at the selected detail level. Information outside the window may therefore be included. The window limits selection, not every piece of series information. All-day events remain all-day.

Home Assistant 2025.4 or later

This example belongs under automation: in configuration.yaml. Replace calendar.familie with your entity ID. In the YAML editor for a single automation, use only the entry starting at alias, without automation: or the leading list marker. Calendar triggers use previously loaded data, so a last-minute change needs a timely refresh.

  1. Go to Settings → Devices & services → Add integration → Remote Calendar. Enter a calendar name and the HTTPS link. No AllMailHub password or Basic Auth is required.
  2. The default refresh interval is 24 hours. To fetch more frequently, open the integration’s menu → System options, disable “Enable polling for changes”, then create an automation using homeassistant.update_entity.

configuration.yaml – refresh every 15 minutes

automation:
  - alias: MailHub calendar every 15 minutes
    triggers:
      - trigger: time_pattern
        minutes: "/15"
    actions:
      - action: homeassistant.update_entity
        target:
          entity_id: calendar.familie

Outlook.com and Outlook on the web

Outlook.com refreshes approximately every three hours, but updates can take more than 24 hours. Outlook on the web has no guaranteed fixed interval. Importing a file only creates a snapshot and receives no updates.

  1. Choose Add calendar → Subscribe from web, enter the HTTPS link and confirm the subscription.

Google Calendar

Google must be able to reach the host over the internet. A local address or a signed-in browser session is not sufficient. Use a valid HTTPS certificate. Google does not specify a fixed refresh interval.

  1. On a computer, open Google Calendar. Next to “Other calendars”, choose “+ → From URL” and paste the HTTPS link.

Apple Calendar

The app controls the schedule. Subscribe instead of importing a file once.

  1. Open the webcal:// link, or choose File → New Calendar Subscription and enter the address. Choose the automatic refresh interval.

Reset, delete and paused links

Reset generates a new secret and immediately disables the old link. Update the address in every app using it. Deleting a link prevents future fetches, but apps may retain copies already downloaded.

After a downgrade below Pro, links remain stored but paused. Editing and deleting remain available. An upgrade reactivates the same link. Moving a calendar to trash pauses it; restoring the calendar reactivates it. Transferring ownership deletes all links.

After a complete database restore, the operator deletes restored links before enabling feeds again. Create new links afterwards. This does not apply to restoring an individual calendar from trash.

If events are missing

  • Check the plan, calendar trash and whether the link was reset or deleted. Repeated failed requests can trigger a temporary rate limit.
  • Large calendars or expensive recurring series can hit existing query limits. AllMailHub returns an error instead of a silently truncated calendar.
  • Test a single event, an all-day event and a series with a moved occurrence, then request a refresh in the subscribing app.

Updated on

Still have questions?

Write to us at info@allmailhub.com.

Start for free