For the complete documentation index, see llms.txt.

POST /v1/calendars/apple/connect

Connect Apple (iCloud) Calendar

Connect an iCloud calendar via CalDAV. Apple has no OAuth — submit an Apple ID and a 16-character **app-specific password** (created at appleid.apple.com → Sign-In and Security → App-Specific Passwords). The credential is validated against iCloud, then stored encrypted. Every calendar on the account is selected for sync by default. **Single active provider:** connecting Apple replaces the currently active Google/Microsoft connection and clears its stale availability — the `replaced` field reports what was deactivated so the UI can warn the user.

Auth required: Yes

Request Body

• apple_id: string (required) — The iCloud account's Apple ID (usually an email).
• app_password: string (required) — A 16-character app-specific password (not the account password).

Responses

• 200: Apple calendar connected
• 401: Invalid Apple credentials
• 422: Authenticated but no event calendars on the account

Authentication

Requires authentication. Pass a Bearer token (Supabase JWT) or an API key (`Authorization: Bearer vennio_sk_live_*`) in the request headers.

Base URL: https://api.vennio.app