> For the complete documentation index, see [llms.txt](https://docs.cipp.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cipp.app/user-documentation/identity/administration/vacation-mode/add-vacation-schedule.md).

# Add Vacation Schedule

This wizard schedules a set of temporary changes for one or more users and the reversal of each, so a period of absence is set up once and undone automatically. Five kinds of change are available and any combination can be used, but at least one has to be enabled before the wizard will continue.

{% stepper %}
{% step %}

### Tenant Selection

The tenant the changes apply to. This defaults to the tenant selected in the top menu and can be changed here.
{% endstep %}

{% step %}

### User Selection

The users the vacation applies to. Several can be selected, and the changes below are applied to each of them.
{% endstep %}

{% step %}

### Vacation Actions

Five switches, each revealing its own settings. Enable whichever apply.

#### Enable CA Policy Exclusion

Excludes the selected users from Conditional Access policies for the duration.

| Field                          | Description                                                                                                                                                                |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Conditional Access Policies    | The policies to exclude the users from. At least one is required. The list is read from the tenant chosen in step one, so a tenant has to be selected before it populates. |
| Create temporary travel policy | Creates a named location for the travel destination and a policy that blocks sign-ins from everywhere else, then deletes both at the end date.                             |
| Travel destination countries   | The countries the users are travelling to. Required when a travel policy is being created.                                                                                 |

{% hint style="warning" %}
Excluding someone from a Conditional Access policy allows sign-ins from anywhere, which is a wider gap than the trip usually warrants. The temporary travel policy is there to close it, restricting sign-ins to the destination for the same period.
{% endhint %}

#### Exclude from location-based audit log alerts

Suppresses the alerts that would otherwise fire on sign-ins from an unusual location, by putting the users on the audit log alert exclusion list at the start date and taking them off again at the end date. This stands on its own: it needs no Conditional Access policy, so tenants without any still get to quiet the alerts for the trip.

#### Enable Mailbox Permissions

Grants delegates temporary access to the users' mailboxes.

| Field                        | Description                                                                                                                                                                                       |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Delegates                    | The users receiving access. At least one is required.                                                                                                                                             |
| Permission Types             | Any combination of `Full Access`, `Send As`, and `Send On Behalf`. At least one is required.                                                                                                      |
| Auto-Map Mailbox             | Lets Outlook add the mailbox on its own for the delegate. Offered with `Full Access`.                                                                                                             |
| Include Calendar Permissions | Grants access to the calendar as well as the mailbox.                                                                                                                                             |
| Calendar Permission Level    | The access level on the calendar: `Owner`, `Publishing Editor`, `Editor`, `Publishing Author`, `Author`, `Non Editing Author`, `Reviewer`, `Contributor`, `Limited Details`, or `Available Only`. |
| Can View Private Items       | Allows the delegate to see items marked private.                                                                                                                                                  |

#### Enable Mail Forwarding

Forwards the users' mail for the duration.

| Field                                                     | Description                                                                    |
| --------------------------------------------------------- | ------------------------------------------------------------------------------ |
| Forward to Internal Address / Forward to External Address | Whether mail goes to another recipient in the tenant or to an outside address. |
| External Email Address                                    | The outside address to forward to.                                             |
| Keep a Copy of the Forwarded Mail in the Source Mailbox   | Delivers the message to the user's own mailbox as well as forwarding it.       |

{% hint style="warning" %}
Forwarding is turned off at the end date rather than returned to how it was. Any forwarding the mailbox had configured beforehand is not restored, so check that first if the user already had a forward set.
{% endhint %}

#### Enable Out of Office

Sets automatic replies for the duration.

| Field                                                    | Description                                                                                                       |
| -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Internal Message                                         | The reply sent to people inside the organisation. Pre-filled with the mailbox's current message where one is set. |
| External Message (optional)                              | The reply sent to people outside the organisation.                                                                |
| Block my calendar for this period                        | Creates a calendar event covering the absence, with a subject of your choosing.                                   |
| Automatically decline new invitations during this period | Declines invitations arriving during the absence.                                                                 |
| Decline and cancel my meetings during this period        | Declines and cancels meetings already booked, with an optional message to organisers.                             |

{% hint style="info" %}
Turning automatic replies off at the end date preserves whatever the message says at that point, so a user who edits their own reply while away does not have it overwritten.
{% endhint %}
{% endstep %}

{% step %}

### Schedule

| Field                  | Description                                                                                                                                                                         |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Scheduled Start Date   | When the changes are applied.                                                                                                                                                       |
| Scheduled End Date     | When they are reversed.                                                                                                                                                             |
| Post Execution Actions | Which channels are notified as the tasks run: Webhook, Email, or PSA.                                                                                                               |
| Reference              | Free text carried onto every task the vacation creates, which is what ties them together on the [Vacation Mode](/user-documentation/identity/administration/vacation-mode.md) page. |
| {% endstep %}          |                                                                                                                                                                                     |

{% step %}

### Review & Submit

A summary of everything selected. Submitting creates the scheduled tasks.
{% endstep %}
{% endstepper %}

***

## Feature Requests / Ideas

We value your feedback and ideas. Please raise any [feature requests](https://github.com/CyberDrain/CIPP/issues/new?template=feature.yml) on GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cipp.app/user-documentation/identity/administration/vacation-mode/add-vacation-schedule.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
