calcom-api

Interact with the Cal.com API v2 to manage scheduling, bookings, event types, availability, and calendars. Use this skill when building integrations that need to create or manage bookings, check availability, configure event types, or sync calendars with Cal.com's scheduling infrastructure.

1. Przygotuj klucz API Cal.com — zaloguj się na konto Cal.com, przejdź do Settings > Developer > API Keys i wygeneruj nowy klucz (będzie prefixowany cal_live_ lub cal_test_). Skopiuj go — będzie potrzebny w następnym kroku.

2. Skonfiguruj zmienne środowiskowe — ustaw CAL_API_KEY na wartość wygenerowanego klucza. Jeśli budujesz integrację platformową zarządzającą użytkownikami w imieniu innych, dodaj także CAL_CLIENT_ID i CAL_SECRET_KEY (opcjonalnie CAL_WEBHOOK_SECRET do weryfikacji webhooków).

3. Połącz się z API — wszystkie żądania kieruj na https://api.cal.com/v2 z nagłówkiem Authorization: Bearer <twój_klucz_api>. Dla integracji platformowych dodaj nagłówki x-cal-client-id i x-cal-secret-key.

4. Wykonaj pierwszą operację — użyj umiejętności do utworzenia rezerwacji, sprawdzenia dostępności lub pobrania konfiguracji typów spotkań. API obsługuje zarządzanie rezerwacjami, zdarzeniami, dostępnością i synchronizacją kalendarzy.

5. Obsługuj webhooks (opcjonalnie) — jeśli chcesz otrzymywać powiadomienia o zmianach rezerwacji, skonfiguruj webhooks w Cal.com i użyj CAL_WEBHOOK_SECRET do weryfikacji autentyczności przychodzących żądań poprzez nagłówek X-Cal-Signature-256.