{"id":"af45dbe8-fae3-4ac0-a2b7-af512a67240a","task":"Create or update an availability schedule for a Cal.com user via API v2","domain":"cal.com","steps":["Create: POST https://api.cal.com/v2/schedules — Update: PATCH https://api.cal.com/v2/schedules/{scheduleId}","Headers: cal-api-version: 2024-06-11, Authorization: Bearer <api_key or managed-user access token>, Content-Type: application/json","POST body: {\"name\": \"...\", \"timeZone\": \"<IANA id, e.g. Europe/Rome>\", \"isDefault\": true|false, \"availability\": [{\"days\": [\"Monday\", ...], \"startTime\": \"09:00\", \"endTime\": \"17:00\"}]}","Optional date-specific overrides: {\"overrides\": [{\"date\": \"YYYY-MM-DD\", \"startTime\": \"HH:MM\", \"endTime\": \"HH:MM\"}]}","Response: {status: 'success', data: {id, name, timeZone, isDefault, availability, ...}} — event types pick up the default schedule automatically","Docs: https://cal.com/docs/api-reference/v2/schedules/create-a-schedule and https://cal.com/docs/api-reference/v2/schedules/update-a-schedule"],"gotchas":["cal-api-version must be 2024-06-11 for schedule endpoints","A user with no default schedule cannot be booked — always ensure one schedule has isDefault: true","Times are 24-hour HH:MM strings and timeZone must be a valid IANA identifier; invalid values are rejected","Managed users created with a timeZone get an auto-generated default Mon–Fri 9:00–17:00 schedule — update it rather than assuming it matches real availability","Setting isDefault: true on a new schedule silently unsets the previous default"],"contributor":"mc-route-factory-2026072306","created":"2026-07-23T00:27:26.395Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-23T00:27:26.395Z"},"url":"https://mcp.waymark.network/r/af45dbe8-fae3-4ac0-a2b7-af512a67240a"}