Outlook Calendar Sync


All add-ons for Bookly require Bookly PRO installed and activated.

Bookly Outlook Calendar (Add-on) enables seamless real-time synchronization between your Bookly Calendar and Outlook Calendar. This integration ensures that all your calendar data remains up-to-date, helping you stay organized, avoid scheduling conflicts, and never miss important appointments.

Setup and configuration

1. Purchase, download, install and activate the Bookly Outlook Calendar (Add-on) in Plugins.

2. Read carefully and follow the instructions in Settings > Outlook Calendar (admin area of your Bookly) to set up the connection between two calendars.

Important: Your website must use HTTPS. The Outlook Calendar API requires a valid SSL certificate installed on your web server for proper functionality.

To find your Application ID and Application Secret, do the following:

1. Sign in to the Azure portal using either a work or school account or a personal Microsoft account.

2. If your account gives you access to more than one tenant, select your account in the top right corner, and set your portal session to the Azure AD tenant that you want.

3. Select Microsoft Entra ID. Then click + Add > App registration.

Microsoft Entra ID – App registration

Microsoft Entra ID – App registration

4. When the Register an application page appears, enter your application's Name and Redirect URI found in Bookly menu > Settings > Outlook Calendar. Under the Redirect URI, in Select a platform field, choose Web. Make sure that the Supported account types is set to Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox). When finished, click Register.

Register an application in Microsoft Entra ID

5. Azure AD assigns a unique application (client) ID to your app, and you're taken to the Home page. Find your application in App registrations > All applications, and select it.

6. Copy the Application (client) ID. Use it in the Application ID field in Bookly settings.

App overview in Microsoft Entra ID

7. Under Certificates & secrets, choose New client secret, set Expires to 24 months, add description and click Add. Insert the secret into the Application secret field in Bookly.

Microsoft Entra ID – Certificates & secrets

Microsoft Entra ID – Certificates & secrets

8. Under API permissions, choose Add a permission, and select Microsoft Graph > Delegated permissions. In Select permissions find Calendars.ReadWrite, select it and click Add permissions button.

Microsoft Entra ID – API permissions

9. Save the changes.


3. Go to the Staff Members section, select a staff member, click Edit > Advanced. Click Sign in with Microsoft.

Staff Members section in Bookly

4. In Settings > Outlook Calendar, choose a mode of synchronization according to your preference and needs.

Bookly Settings – Outlook Calendar

One-way sync – all new appointments created in Bookly Calendar and any further changes will appear in Outlook Calendar.

Two-way front-end only – all updates made within Bookly will automatically sync to your Outlook Calendar. Events initially created in Outlook Calendar will not be mirrored in Bookly Calendar. Bookly will consider time slots occupied by Outlook Calendar events as unavailable for booking.

Two-way sync – all new bookings created or updated in Bookly Calendar will be automatically reflected in the Outlook Calendar, and vice versa.

5. If you've chosen the Two-way sync mode, you can specify the number of past days' calendar data you want to sync in the Sync appointments history field. For instance, entering '1' will sync appointments starting from yesterday.

The initial synchronization process may take a while depending on the volume of events to be synchronized.

6. The Limit number of fetched events option allows you to restrict the number of events fetched. This prevents memory issues in PHP that may arise when Bookly attempts to retrieve a large number of events from the Outlook calendar.

7. Bookly allows you to set up the way your booking information will be displayed in Outlook Calendar.

For the event title template, select the details you want to include for the Outlook Calendar event description generated by Bookly. You can use the following codes: {service_name}, {category_name}, {staff_name}, and {client_names}.

In the event description template, use codes for appointment-related information that you want to display in the Outlook Calendar.

Beginning with Bookly PRO 3.6, use {participant.client_email} instead of {client_email} within the {#each participants as participant}{/each} structure when configuring your Outlook Calendar event description. This change improves the display of appointment details for group bookings in Outlook Calendar.

Manual synchronization

To manually synchronize your calendars, click on the Outlook Calendar button located at the top right corner of the Bookly Calendar interface.

Note: While we use the Outlook API for synchronization, not all Outlook mailboxes are supported by this API. If you encounter difficulties syncing your Bookly staff member with their Outlook account, it may be due to mailbox compatibility issues. For more detailed information, please refer to this article.


Was this article helpful?
1 out of 1 found this helpful

Articles in this section