Integrations & API

Calendar Sync Integration

iCal feeds, Google Calendar, and Apple Calendar integration.

3 min readUpdated 2025-01-12

When you run gatherings for a community that comes back again and again — a weekly kirtan circle, a monthly sound bath, a retreat that repeats each season — people want your events sitting in their own calendar app, not buried in an inbox somewhere. BrightStar handles this in two different ways, and knowing which one to point someone toward saves a lot of confusion at the door. An iCal feed is something a person subscribes to once, and it keeps updating on its own as you add new events. Adding a single event to a calendar is a one-time action someone takes from an event page or a confirmation email, and it only ever covers that one gathering. The rest of this article walks through both.

What are the three iCal feeds BrightStar publishes?

BrightStar gives you three separate feed URLs, each meant for a different reader:

  1. 1Organizer event feed (https://brightstarevents.com/ical/{org_slug}/events.ics) — every event you run, in one feed. Hand this to someone who follows your whole schedule, not just a single date.
  2. 2Single event feed (https://brightstarevents.com/ical/event/{event_id}.ics) — just one gathering. Use this when you're promoting one retreat or ceremony and don't want to pull someone into everything else you run.
  3. 3Attendee's purchased events feed (https://brightstarevents.com/ical/my-events/{user_token}.ics) — a personal feed tied to one person's account, showing only the events they've actually bought a ticket to.

How often do Google Calendar, Apple Calendar, and Outlook refresh the feed?

Once someone subscribes to a BrightStar feed, the syncing is handled by their calendar app, not by BrightStar. Google Calendar checks the feed roughly every 24 hours, and that interval is set by Google rather than something you or the subscriber can change. Apple Calendar lets the subscriber pick a sync frequency when they set up the subscription, defaulting to daily if they leave it alone. Outlook checks the feed about every 24 hours as well. The practical effect is the same across all three: if you add a new event or change a start time, it can take the better part of a day to show up on someone's synced calendar. For anything time-sensitive close to the day of a gathering, an email to attendees is a better way to reach them than waiting on the feed to refresh.

What happens when you click 'Add to Calendar'?

The Add to Calendar button appears on your event pages and inside confirmation emails, with options for Google, Apple, Outlook, Yahoo, and a plain ICS download. Clicking it builds a calendar entry from what BrightStar knows about the event: the title and description, the start and end time with timezone, the venue address with a map link, and your contact information as the organizer. This is a one-time download rather than a subscription — once it's sitting in someone's calendar, it's a copy, so if you later move the start time or change the venue, that existing entry doesn't update itself. It's worth telling attendees to check their confirmation email or your event page again if something changes close to the date, rather than assuming their calendar caught the update.

Put the organizer feed URL in your website footer or email signature. Anyone who subscribes there sees every event you add show up automatically in their own calendar going forward, so you're not stuck sending a reminder each time you post something new.

Feed subscription or single-event add — which one should you point people to?

The two options solve different problems. A feed subscription is for someone who wants to follow everything you do without thinking about it again — good for a regular at your weekly meditation circle, or a follower who wants to see every retreat you announce. Send them the organizer feed link. A single-event add is for someone who just needs one gathering locked into their calendar and isn't necessarily coming back for the rest of your schedule — that's what the Add to Calendar button on the event page and confirmation email is for. The trade-off is that the feed stays current on its own but only refreshes on the calendar app's schedule, while the single add is instant but frozen the moment it's created. Neither is better; they answer different questions about how someone plans to keep coming back.

Common questions

Can people subscribe to a calendar feed of all my events?

Yes. BrightStar publishes an organizer iCal feed at https://brightstarevents.com/ical/{org_slug}/events.ics covering all your events. There is also a single-event feed at https://brightstarevents.com/ical/event/{event_id}.ics and a personal feed of an attendee's purchased events at https://brightstarevents.com/ical/my-events/{user_token}.ics.

Read more

The three feeds serve different situations at your gate or check-in desk: the organizer feed suits someone who follows everything you run — a kirtan circle every week, say — while the single-event feed suits promotion of one retreat without pulling people into your full schedule. The purchased-events feed only shows what a specific attendee has actually bought, keeping their calendar limited to their own tickets.

How do I add a BrightStar iCal feed to Google Calendar?

Add the BrightStar feed URL under Other calendars in Google Calendar. Google controls the refresh rate and syncs subscribed feeds roughly every 24 hours, so new events may take up to a day to appear.

Read more

Because Google — not BrightStar — controls the refresh, a newly added event or a last-minute time change to an existing one can take up to a day to show up in someone's Google Calendar. If you're announcing a change close to the day of a gathering, it's worth also emailing attendees directly rather than counting on the feed to catch up in time.

Does the calendar feed work with Apple Calendar and Outlook?

Yes. In Apple Calendar choose File then New Calendar Subscription and paste the BrightStar feed URL, with sync frequency configurable and defaulting to daily. In Outlook choose Add calendar then From internet and paste the same URL, which syncs every 24 hours.

Read more

Apple Calendar lets the subscriber choose how often it checks the feed, though daily is the default if they don't change it; Outlook, like Google, is fixed at roughly once every 24 hours. In practice this means any of the three can lag behind your actual event listing by the better part of a day, which matters most for last-minute schedule changes.

Can attendees add my event to their own calendar?

Yes. BrightStar shows an Add to Calendar button on event pages and in confirmation emails, with options for Google, Apple, Outlook, Yahoo and an ICS download. Clicking it generates an entry containing the event title and description, start and end times with timezone, the venue address with a map link, and organizer contact info.

Read more

The file is a one-time download, not a live subscription, so once imported it becomes a copy that won't update if you later change the event. Times are stored in UTC and converted to the reader's own timezone on import; if no end time is set, the entry defaults to two hours. The description includes ticket type, quantity, and order reference, and festival events offer a similar per-session export.

Where should I put my iCal feed link so people find it?

BrightStar suggests including the iCal feed URL in your website footer or email signature. Anyone who subscribes will then see all your events update automatically in their own calendar rather than having to check back for new listings.

Read more

A footer or signature link works because it reaches people passively, at a moment when they're already reading something from you rather than actively hunting for your event page. Once someone subscribes there, every future event you create appears in their calendar without them re-subscribing or you having to send a separate reminder for each new listing.

Ready to get started?

Create your first event on EveryEvent Rio de Janeiro — it’s free.