Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cal.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Organization admins can control how and when booking guests receive notifications. These settings define the default notification behavior for all members in the organization, while individual users can still override preferences at their own level.

​
How notification precedence works

Cal.com resolves notification preferences using a hierarchical model:
  1. Organization defaults — set by the org admin, applied to all members
  2. User overrides — individual members can override organization defaults
When a notification event occurs (for example, a booking confirmation), Cal.com checks whether the user has a personal preference set. If not, the organization default applies.

​
Supported notification events

The following booking events can trigger guest notifications:
EventDescription
Booking confirmedA new booking is confirmed
Booking cancelledAn existing booking is cancelled
Booking rescheduledA booking is rescheduled to a new time
Booking reminderA reminder is sent before the booking

​
Supported notification channels

Organization admins can enable or disable notifications across these channels:
  • Email — standard email notifications to guests
  • Web push — browser push notifications for users with an active Cal.com session
  • SMS — text message notifications (when a phone number is available)

​
Configuring organization notification defaults

1

Navigate to organization settings

Go to Settings → Organization → Notification preferences in your Cal.com admin panel.
2

Set default preferences

For each notification event, choose which channels should be enabled by default for all organization members.
3

Save changes

Click Save to apply the new defaults. These settings take effect immediately for all members who have not set their own overrides.
By default, all notification channels are enabled for all events. Organization settings only need to be configured if you want to restrict or customize the default behavior.

​
User-level overrides

Individual organization members can override the organization defaults from their personal notification settings:
  1. Go to Settings → Notifications
  2. Adjust preferences for specific events or channels
  3. Save changes
User-level preferences always take priority over organization defaults.

​
API configuration

You can also manage notification preferences programmatically using the Cal.com API. Organization notification preferences are managed through the organization settings endpoints. 
# Example: Update organization notification preferences
curl -X PATCH https://api.cal.com/v2/organizations/{orgId} \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "notificationPreferences": {
      "bookingConfirmed": {
        "email": true,
        "webPush": true,
        "sms": false
      },
      "bookingCancelled": {
        "email": true,
        "webPush": false,
        "sms": false
      }
    }
  }'
Refer to the API v2 Reference for full details on available endpoints and parameters.