Skip to main content

CalDAV Setup

CalDAV lets you view and manage hosted calendar events directly in your favorite calendar app. Changes made in the app sync back to CalendarPipe in real time.

Credentials​

FieldValue
Server URLhttps://www.calendarpipe.com/api/caldav/
UsernameYour CalendarPipe account email
PasswordYour CalendarPipe API key
Principal URL (if required)https://www.calendarpipe.com/api/caldav/principals/{userId}/
tip

Your API key is available in Settings > API Keys. Use the API key as the password — not your account password.

danger

The trailing slash on the Server URL is required. Omitting it will cause connection failures in most CalDAV clients.

Apple Calendar​

Screenshot: Apple Calendar CalDAV account setup dialog

  1. Open System Settings > Internet Accounts (on macOS Ventura and later) or Calendar > Settings > Accounts (on older macOS).
  2. Click Add Other Account (or the + button), then select CalDAV Account.
  3. Set the account type to Manual.
  4. Enter the Server URL, Username (your CalendarPipe email), and Password (your API key).
  5. Click Sign In.
info

After signing in, auto-discovery of your calendars may take a few minutes. If calendars do not appear immediately, wait and refresh.

Thunderbird​

Screenshot: Thunderbird new calendar setup dialog

  1. Open Thunderbird and switch to the Calendar tab.
  2. Right-click in the calendar list panel and select New Calendar.
  3. Select On the Network and click Next.
  4. Set Format to CalDAV and paste the Server URL into the Location field.
  5. Click Find Calendars and enter your Username and Password (API key) when prompted.
  6. Select the calendars you want to subscribe to and click Subscribe.

Generic CalDAV Client​

Use these credentials with any CalDAV-compatible client:

FieldValue
Server URLhttps://www.calendarpipe.com/api/caldav/
UsernameYour CalendarPipe account email
PasswordYour CalendarPipe API key
Principal URLhttps://www.calendarpipe.com/api/caldav/principals/{userId}/
Auth methodBasic authentication
SSL / TLSRequired

The Principal URL is only needed for clients that cannot auto-discover calendars from the server URL alone.

Troubleshooting​

ProblemSolution
Cannot connect to serverVerify the Server URL includes the trailing slash: https://www.calendarpipe.com/api/caldav/
Wrong password / authentication failedThe password must be your CalendarPipe API key, not your account password. Generate one in Settings > API Keys.
Calendars not appearing after sign inAuto-discovery may take a few minutes. Wait and refresh the account.
Client requires Principal URLUse https://www.calendarpipe.com/api/caldav/principals/{userId}/ where {userId} is your CalendarPipe user ID.

Next Steps​