> ## 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.

# Guest notification settings

> Configure organization-level notification preferences for booking guests

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:

| Event               | Description                            |
| ------------------- | -------------------------------------- |
| Booking confirmed   | A new booking is confirmed             |
| Booking cancelled   | An existing booking is cancelled       |
| Booking rescheduled | A booking is rescheduled to a new time |
| Booking reminder    | A 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

<Steps>
  <Step title="Navigate to organization settings">
    Go to **Settings** → **Organization** → **Notification preferences** in your Cal.com admin panel.
  </Step>

  <Step title="Set default preferences">
    For each notification event, choose which channels should be enabled by default for all organization members.
  </Step>

  <Step title="Save changes">
    Click **Save** to apply the new defaults. These settings take effect immediately for all members who have not set their own overrides.
  </Step>
</Steps>

<Note>
  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.
</Note>

## 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.

```bash theme={null}
# 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
      }
    }
  }'
```

<Info>
  Refer to the [API v2 Reference](/api-reference/v2/introduction) for full details on available endpoints and parameters.
</Info>