---
title: "Connect iCloud Calendar"
method: POST
path: "/api/v1/calendars/apple"
tags: ["account"]
---

# Connect iCloud Calendar

`POST /api/v1/calendars/apple`

## Request

- Base URL: `https://meettempi.com`
- URL: `https://meettempi.com/api/v1/calendars/apple`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `tempi_session`

Connects an iCloud calendar over CalDAV. Apple has no OAuth for calendars, so this needs the Apple ID email and an app-specific password from https://account.apple.com → Sign-In and Security → App-Specific Passwords. The credentials are checked, then stored encrypted. Your first connected calendar becomes the booking calendar.

## Request body

- object
  - `appleId` string, email, required: an email address
  - `appPassword` string, required: a string that will be trimmed
  - `serverUrl` string: an https CalDAV server URL (advanced, defaults to iCloud)

## Response `201`

Success

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/meettempi/apis/tempi-api.md) · [All operations](https://skmtc.dev/meettempi/apis/tempi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meettempi/apis/tempi-api/revisions/36787210a2ce?raw)