> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 📅 How to integrate Appointment Bookings App with Outlook Calendar

Connecting your Outlook Calendar keeps your bookings organized and prevents double-bookings. Once set up, every confirmed appointment is added to your Outlook Calendar, and existing Outlook events can block your available time slots automatically.

If you also use Microsoft Teams, the same connection lets you generate Teams meeting links for online appointments ✨

---

# **⚠️ Before You Begin**

Before connecting Outlook Calendar, make sure you have:

* A **Microsoft or Outlook account** with calendar access  
* Permission to authorize third-party apps on that account  
* The **Hoppy Appointments** app installed on your Shopify store

💡 The Outlook connection is tied to a **team member**, usually the store admin or the person whose calendar should receive the bookings.

---

# **🛠️ Step 1 — Connect Outlook Calendar to Your Team**

1. Open the **Hoppy Appointments** app  
2. Go to **Team** in the navigation  
3. Select the team member whose Outlook Calendar you want to connect  
4. On the **General Settings** tab, scroll to the **Outlook integration** card  
5. Click **Connect Outlook**  
6. Read the prompt and click **Connect** again  
7. Sign in to your Microsoft account and approve the calendar permissions  
8. Once authorized, you are returned to the team member page

You’ll see a success message and a **Connected** badge next to Outlook.

---

# **🛠️ Step 2 — Configure Calendar Settings**

After connecting, click **Configure Outlook Calendars**. This opens the calendar settings where you choose how Outlook should work with the app.

---

## **Calendar to use (Event Creation)**

Choose the Outlook calendar where new booking events should be added. This is usually your main calendar.

---

## **Calendars to Check for Conflicts**

Select one or more calendars the app should watch to prevent overlapping bookings. For example, if you have a personal calendar and a work calendar, you can check both so customers cannot book a time when you are already busy.

---

## **Enable two-way sync**

Turn this on if you want existing events on your primary calendar to block available booking slots. When enabled, the app reads your Outlook events and removes those times from your storefront booking calendar.

When turned off, the app only writes new booking events to Outlook but does not check your existing Outlook events for conflicts.

Click **Apply** to save your calendar configuration.

---

# **🛠️ Step 3 — Use MS Teams as a Meeting Location (Optional)**

Because Outlook and Microsoft Teams share the same connection, you can automatically generate Teams meeting links for appointments.

1. Open the service you want to use with Teams  
2. In the **General** tab, find the **Meeting location** card  
3. Select **MS Teams**  
4. Save the service

When a customer books, a Teams meeting is created automatically and the join link is shared in their confirmation email.

---

# **🛠️ Step 4 — Save and Test**

1. Make sure your service is saved  
2. Preview the booking widget on your storefront  
3. Complete a test booking  
4. Check your Outlook Calendar — the booking should appear as a new event  
5. If you enabled two-way sync, block a time in Outlook and confirm it is no longer available for booking

---

# **⚠️ Important Notes**

* **One Outlook account per team member.** The connection is tied to the team member, not the entire store.  
* **The right person needs to be connected.** For services using **Availability per service**, connect the admin or host. For services using **Availability per teammate**, connect each teammate whose calendar should sync.  
* **Two-way sync reads your Outlook events.** This prevents customers from booking times that are already blocked in Outlook.  
* **Booking events are written to Outlook.** Each confirmed booking creates an event on the selected calendar with the customer and meeting details.  
* **Disconnect anytime.** You can remove the Outlook connection from the team member detail page. Existing Outlook events stay as they are; new bookings will no longer sync.  
* **MS Teams requires the same Outlook connection.** You do not need a separate integration for Teams meetings.

---

# **🐞 Troubleshooting**

## **Connect Outlook button does nothing**

Make sure your browser allows pop-ups or redirects from the Shopify admin. The Microsoft OAuth flow needs to open Microsoft’s authorization page.

## **Outlook shows as Not connected after authorizing**

Try refreshing the team member page. If it still shows as not connected, disconnect and reconnect Outlook.

## **Bookings are not appearing in Outlook**

Check that:

* Outlook is connected for the team member who is the assigned organizer  
* A **Calendar to use (Event Creation)** is selected in the configuration  
* The booking was confirmed successfully

## **Existing Outlook events are not blocking booking slots**

Make sure **Enable two-way sync** is turned on in the Outlook calendar configuration, and that the calendar containing those events is selected under **Calendars to Check for Conflicts**.

## **MS Teams link is not generated**

Check that:

* Outlook is connected for the assigned team member  
* The service **Meeting location** is set to **MS Teams**  
* The booking was confirmed successfully

## **I want to stop syncing Outlook for one team member**

Go to the team member detail page, find the **Outlook integration** card, and click **Disconnect Outlook**. Existing synced events remain in Outlook; new bookings will no longer be added.

---

# **🎉 Final Result**

Once configured:

✅ Outlook Calendar is connected to the right team member ✅ Confirmed bookings appear automatically in Outlook ✅ Existing Outlook events can block available time slots ✅ MS Teams meeting links can be generated automatically ✅ Customers cannot book times when you are already busy

---

# **📚 Related Articles**

* **How to Configure Meeting Locations for Appointment Bookings**  
* **How to Set Up Appointment Booking Services**  
* **Working with Team in Appointment Bookings**  
* **How to Configure Email Notifications for Appointment Bookings**