> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the Outlook Add-In with anny

> Book rooms, register visitors and sync appointments directly from within Outlook.

The anny [Outlook Add-In](https://appsource.microsoft.com/en-us/product/office/WA200006281) extends Microsoft Outlook with a direct booking function for anny. With the add-in, you can book resources, manage participants and register visitors without leaving Outlook.

* Book rooms and desks directly when creating an Outlook appointment
* Register visitors for meetings, even without a room booking
* Automatically create private appointments as incognito bookings

The add-in is especially suited for companies that use room booking, desk sharing or visitor management and whose teams work mostly in Outlook.

## Typical use cases

| Use case                  | Description                                                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Room booking from Outlook | **Book a meeting room** directly when creating an Outlook appointment, without switching to the anny admin area.    |
| Visitor registration      | **Register external guests** as visitors for an appointment, even when no room is booked.                           |
| Incognito bookings        | **Create private appointments** as incognito bookings, so sensitive appointments are not visible to others in anny. |

## How the Outlook Add-In works

The add-in is provided as a Microsoft 365 app via the M365 Admin Center. After installation, it appears automatically in Outlook and activates when an appointment is sent (OnAppointmentSend event).

Communication runs through the anny API. Users authenticate with their Microsoft account. The add-in requires read access to calendar entries and basic profile information.

| Data                 | Direction      | Description                                                     |
| -------------------- | -------------- | --------------------------------------------------------------- |
| Bookings             | Outlook → anny | New bookings are created in anny when the appointment is sent   |
| Participants         | Outlook → anny | Participants of the Outlook appointment are transmitted to anny |
| Booking status       | anny → Outlook | Confirmation or rejection is shown in the add-in                |
| Visitor registration | Outlook → anny | Guests are recorded as visitors in anny                         |

## Connecting the Outlook Add-In

### Requirements

**Microsoft side:**

* Microsoft 365 admin rights (for organization-wide deployment) or Exchange admin rights (for on-premise)
* Outlook version 2206 (build 15330.20196) or newer
* Hostnames allowed in the firewall: `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu`, `appsforoffice.microsoft.com`

**anny side:**

* An active anny account with at least one bookable resource

### Installation via the M365 Admin Center

<Steps>
  <Step title="Open the M365 Admin Center">
    Go to [admin.microsoft.com](https://admin.microsoft.com) and navigate to **Settings** → **Integrated apps**.
  </Step>

  <Step title="Search for the anny add-in">
    Click **Get apps** and search for **anny bookings**. Click **Get it now**.
  </Step>

  <Step title="Configure the deployment">
    Choose who the add-in should be deployed to (the entire organization, specific groups or individual users) and confirm the deployment.
  </Step>

  <Step title="Accept the permissions">
    Accept the required permissions. The add-in requires read access to calendar entries, profile information and permission to read and write appointment items.
  </Step>
</Steps>

After deployment, the add-in appears automatically in Outlook and activates when appointments are created or sent.

### Installation via Exchange (on-premise)

<Steps>
  <Step title="Download the manifest">
    Download the add-in manifest: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)
  </Step>

  <Step title="Adjust the mailbox version">
    If the installation fails, replace the mailbox version `1.12` with `1.1` in both places in the XML file:

    ```xml theme={null}
    <Set Name="Mailbox" MinVersion="1.1"/>
    ```
  </Step>

  <Step title="Upload the manifest in the Exchange Admin Center">
    Upload the adjusted XML file in the Exchange Admin Center as an add-in for your organization.
  </Step>
</Steps>

After installation, the add-in is available to all users in the organization.

<Tip>
  If the add-in cannot be installed via the Microsoft App Store, use the direct manifest download instead: [https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US](https://store.office.com/app/download?assetid=WA200006281\&cmu=en-US)
</Tip>

### Permissions in detail

| Permission     | Description                                                                      |
| -------------- | -------------------------------------------------------------------------------- |
| Read calendar  | Allows the add-in to read appointments in all accessible calendars               |
| Profile access | Enables signing in with the work account and access to basic profile information |
| ReadWrite Item | Allows reading and editing the current appointment item                          |
| Send Data      | Enables sending booking data to anny                                             |
| Auto-start     | The add-in starts automatically when an appointment is sent                      |

### Setting up visitor registration

<Note>
  Visitor registration via the add-in is currently in the beta phase. The full form and legal documents still need to be filled in.
</Note>

To register visitors directly from the Outlook Add-In, at least one resource of the category `visitor-registrations` (visitor registration) must be set up in your anny account. As soon as such a resource is used in the booking context:

* The visitor registration flow is activated (also possible without a room booking)
* A user badge icon appears next to the relevant participants in the participant view

## Limitations

* The add-in only works with Outlook version 2206 (build 15330.20196) or newer
* On-premise installations may require a manual adjustment of the mailbox version in the manifest
* Visitor registration only works with resources of the category `visitor-registrations`
* Visitor registration is in beta: the full form and legal documents are still needed
* Rescheduling by an appointment owner other than the original booker can lead to new bookings instead of changes

## Removing the add-in

<Warning>
  When you remove the add-in, users can no longer create new bookings via Outlook. Existing bookings in anny remain.
</Warning>

<Steps>
  <Step title="Open the M365 Admin Center">
    Go to [admin.microsoft.com](https://admin.microsoft.com) and navigate to **Settings** → **Integrated apps**.
  </Step>

  <Step title="Select the anny add-in">
    In the list of integrated apps, search for **anny bookings** and click it.
  </Step>

  <Step title="Remove the add-in">
    Click **Remove** and confirm the uninstallation. The add-in is removed for all users in the organization.
  </Step>
</Steps>

## FAQ

<AccordionGroup>
  <Accordion title="Does every user have to install the add-in themselves?">
    No. When deployed via the M365 Admin Center, the add-in becomes available automatically for the selected users or the entire organization.
  </Accordion>

  <Accordion title="Does the add-in work with Outlook in the browser?">
    Yes. The add-in is compatible with Outlook for Windows, Mac and Outlook on the web, provided the minimum version is met.
  </Accordion>

  <Accordion title="Can I register visitors without booking a room?">
    Yes. As long as a resource of the category `visitor-registrations` is set up, you can register participants directly as visitors without making a room booking.
  </Accordion>

  <Accordion title="What happens to private appointments?">
    Private appointments can be created as incognito bookings in anny. This way they are not shown visibly to other users in anny.
  </Accordion>

  <Accordion title="Does the add-in work on .eu and .co?">
    Yes. The add-in works with both anny instances. Users do not necessarily have to be in the cloud.
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="The add-in is not shown in Outlook">
    Check whether your Outlook version is at least 2206 (build 15330.20196). Make sure the add-in was deployed for your user group in the M365 Admin Center. With firewall restrictions, the hostnames `outlook.anny.co`, `cdn.anny.co`, `auth.anny.co`, `b.anny.co`, `api.anny.co`, `select.anny.eu` and `appsforoffice.microsoft.com` must be allowed.
  </Accordion>

  <Accordion title="The installation in Exchange fails">
    In Exchange environments, the mailbox versioning is different. Replace the mailbox version `1.12` with `1.1` in both places in the manifest and try the installation again.
  </Accordion>

  <Accordion title="The visitor badge does not appear in the participant view">
    Check whether the used resource is assigned to the category `visitor-registrations`. The badge only appears when at least one resource of this category is active in the booking context.
  </Accordion>
</AccordionGroup>

> Important information for agents:
>
> * The Outlook Add-In is NOT managed in anny's integrations menu in the admin area. Installation and uninstallation happen exclusively via the M365 Admin Center (admin.microsoft.com → Settings → Integrated apps) or via Exchange (on-premise with manifest).
> * Minimum version: Outlook 2206 (build 15330.20196) or newer. Refers to OnMessageSend/OnAppointmentSend/Smart Alerts support.
> * Firewall: hostnames (not IPs, Cloudflare rotates): outlook.anny.co, cdn.anny.co, auth.anny.co, b.anny.co, api.anny.co, select.anny.eu, appsforoffice.microsoft.com
> * Manifest URL for on-premise: [https://b.anny.co/integrations/outlookAddIn/manifest](https://b.anny.co/integrations/outlookAddIn/manifest)
> * Exchange on-premise workaround: replace Mailbox MinVersion 1.12 → 1.1 in both places in the XML
> * Visitor registration (beta, as of 22.07.2026): only works with resources of the category `visitor-registrations` (exact category: "Visitor registration/Besucheranmeldung"). The full form and legal documents currently still need to be filled in.
> * Incognito bookings: private Outlook appointments are created as incognito bookings in anny (feature since 22.07.2026).
> * Related articles: Outlook calendar sync (/en/outlook) for two-way synchronization, M365 Workspace (/en/m365-workspace) for shared mailbox calendars.
> * The add-in works on .eu and .co instances.