Skip to main content
User booking limits let you restrict how many bookings a user can accept across all their event types — both personal and team — within a given time window. This is different from event-type booking limits, which only apply to a single event type.
User booking limits require an organization with the feature enabled. Contact your organization admin if you don’t see this option.

​
How it works

When a user has booking limits configured, Cal.com checks the total number of accepted bookings for that user before allowing a new one. If the user has already reached their limit for the current period, the time slots are marked as unavailable and new bookings are rejected. Limits can be set for any combination of these intervals:
IntervalDescription
perDayMaximum bookings per calendar day
perWeekMaximum bookings per calendar week
perMonthMaximum bookings per calendar month
perYearMaximum bookings per calendar year
You can set one or more intervals simultaneously. For example, you could allow up to 5 bookings per day but no more than 20 per week.
When multiple intervals are set, the stricter limit at any given moment takes precedence. A daily limit of 3 and a weekly limit of 10 means a user can never exceed 3 bookings on a single day, even if they haven’t reached 10 for the week.

​
Setting limits in the UI

You can configure user booking limits in Settings > My Account > General. Toggle the booking limits option, set your desired limits for each interval, and click Update to save.

​
Setting limits via the API

​
Read current limits

User booking limits are returned as part of the GET /v2/me response: 
{
  "bookingLimits": {
    "perDay": 5,
    "perWeek": 20,
    "perMonth": null,
    "perYear": null
  }
}
A null value means no limit is set for that interval.

​
Update limits

Use the PATCH /v2/me endpoint to update booking limits: 
curl -X PATCH https://api.cal.com/v2/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bookingLimits": {
      "perDay": 5,
      "perWeek": 20
    }
  }'
To remove all booking limits, set bookingLimits to null: 
curl -X PATCH https://api.cal.com/v2/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bookingLimits": null
  }'

​
User limits vs event-type limits

Cal.com supports two levels of booking limits:
LevelScopeWhere to configure
User booking limitsAll bookings for a user across every event typeSettings > My Account > General
Event-type booking limitsBookings for a single event type onlyEvent type settings > Limits tab
Both levels are enforced independently. If a user has a daily limit of 5 and an event type has a daily limit of 3, the event type can only receive 3 bookings per day — but the user can still accept 2 more bookings on other event types before hitting their personal cap.

​
Effect on availability

When a user reaches a booking limit for a given period, all time slots within that period are marked as busy. This means:
  • Slots no longer appear as available on booking pages.
  • Attempts to book during that period return an error.
  • The limit resets at the start of the next period (next day, week, month, or year) based on the user’s timezone.