EasyShul EasyShul Public APIs

📅 Calendar Feed (iCal)

Publish your synagogue's events as an iCalendar (.ics) feed that members can subscribe to in Google Calendar, Outlook, Apple Calendar, or any other calendar app. Events stay in sync — when you add or update an event in EasyShul, it appears in subscribers' calendars within a few hours.

Your *.easyshul.com subdomain.

Your subscription URL

This is the URL members will paste into their calendar app:



    

      
        Open the feed in your browser →
      
    


    
How members subscribe


    
Google Calendar

    
    
      
  1. Open Google Calendar on a desktop browser.
    2. 
      
  2. In the left sidebar, hover over Other calendars and click the + button.
    3. 
      
  3. Choose From URL.
    4. 
      
  4. Paste the subscription URL above and click Add calendar.
    5. 
    

    

      Google refreshes external feeds roughly every 6–12 hours. New or changed
      events may take a while to appear.
    


    
Apple Calendar (macOS / iOS)

    
    
      
  1. On macOS: open Calendar → File → New Calendar Subscription…
    2. 
      
  2. On iOS: Settings → Apps → Calendar → Calendar Accounts → Add Account → Other → Add Subscribed Calendar.
    3. 
      
  3. Paste the subscription URL above.
    4. 
      
  4. Set Auto-refresh to your preference (every hour is a good default).
    5. 
    


    
Outlook (Microsoft 365 / Outlook.com)

    
    
      
  1. Open Outlook on the web.
    2. 
      
  2. In the left sidebar, click Add calendar.
    3. 
      
  3. Choose Subscribe from web.
    4. 
      
  4. Paste the subscription URL, give it a name, pick a color, and click Import.
    5. 
    


    
What's in the feed

    
Each event in the feed includes:

    

      
iCal fieldSource

      
        
SUMMARYEvent name

        
DTSTARTEvent date

        
DTENDComputed from event duration

        
LOCATIONEvent address (formatted)

        
DESCRIPTIONEvent description (HTML stripped) + registration window

        
URLVirtual event link (when applicable)

        
UID{eventId}@easyshul

        
DTSTAMPTime the feed was generated

        
CREATED / LAST-MODIFIEDEvent timestamps

        
SEQUENCEUpdate counter so apps detect edits

        
STATUS / TRANSPCONFIRMED / OPAQUE

      
    


    
All non-archived events are included — both past and future — so your calendar shows history as well as upcoming events.


    
Subscription refresh

    

      The feed tells calendar apps to refresh hourly via the REFRESH-INTERVAL
      and X-PUBLISHED-TTL headers. The HTTP response also sets
      Cache-Control: max-age=3600 to keep upstream API load low.
    

    

      Google Calendar ignores these hints and refreshes on its own
      schedule (roughly every 6–12 hours). New events may take a while to
      appear. Apple Calendar and Outlook typically follow the hourly hint.
    


    
Sharing the link

    

      The subscription URL is safe to share publicly — it exposes only what
      anyone with your *.easyshul.com address can already see on the
      EasyShul events page. There are no per-user secrets or tokens in the URL.
    

    

      A common pattern is to add a "Subscribe to our calendar" button on your shul's
      website pointing to this URL. On most operating systems, clicking the link
      opens the user's default calendar app with a subscribe prompt.
    


    

      Heads up: the iCal subscription is one-way. Events are
      read-only in the subscriber's calendar — they can't edit or RSVP from
      there. Use the embed widget if you want a registration form.