Calendar

Calendar integrations allow you to connect external calendar services to Skylite UX. You can view events from multiple calendars in a unified view, and depending on the integration, create, edit, and delete events.

General Setup

  1. In Skylite UX, go to Settings > Integrations > Add Integration
  2. Select Calendar as the type and the service you are setting up
  3. Configure:
    • Credentials: iCal URL, API key, OAuth client ID, etc.
    • User: Select which user(s) to link events to, or leave blank (optional)
    • Event Color: Choose a color for events from this calendar (optional)
    • Use User Profile Colors: Enable to use individual user profile colors instead of a single event color (optional)
  4. Save the integration

iCal

The iCal integration allows you to connect to any calendar that provides an iCal (.ics) feed URL. This is a read-only integration, meaning you can view events from the external calendar but cannot create, edit, or delete events through Skylite UX.

Capabilities

  • Get events: View events from the connected calendar feed

Setup Instructions

  1. Obtain the iCal feed URL from your calendar service
    • Common formats: https://example.com/calendar.ics or webcal://example.com/calendar.ics
    • Many calendar services provide iCal feed URLs in their settings
  2. Follow the general setup instructions above.

Google Calendar

The Google Calendar integration provides full two-way synchronization with your Google Calendar account. You can view, create, edit, and delete events, and select which calendars to sync.

Capabilities

  • Get events: View events from selected Google Calendars
  • Add events: Create new events in Google Calendar
  • Edit events: Modify existing events in Google Calendar
  • Delete events: Remove events from Google Calendar
  • OAuth authentication: Secure authentication using Google OAuth
  • Select calendars: Choose which calendars to sync

Setup Instructions

1. Create Google OAuth Credentials

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Google Calendar API:
    • Navigate to APIs & Services > Library
    • Search for “Google Calendar API”
    • Click Enable
  4. Create OAuth 2.0 credentials:
    • Go to APIs & Services > Credentials
    • Click Create Credentials > OAuth client ID
    • If prompted, configure the OAuth consent screen first
    • Select Web application as the application type
    • Add authorized redirect URIs:
      • http://localhost:3000/api/integrations/google_calendar/callback
      • http://myowndomain.com/api/integrations/google_calendar/callback
    • Click Create
  5. Copy the Client ID and Client Secret
  6. Follow the general setup instructions above.
  7. You will be redirected to Google to authorize the application
  8. After authorization, you will be redirected back to Skylite UX. Configure:
    • Select which calendars to sync
    • Choose user(s) to link events to
    • Set calendar event color
    • Enable/disable user profile colors

Troubleshooting

  • OAuth errors: Ensure your redirect URI is correctly configured in Google Cloud Console
  • Calendar not appearing: Verify the Google Calendar API is enabled in your Google Cloud project
  • Permission denied: Check that you’ve granted the necessary permissions during OAuth authorization
This site uses Just the Docs, a documentation theme for Jekyll.