Help Center

Outlook Calendar Sync

Important: All add-ons for Bookly require Bookly Pro add-on installed and activated.

Bookly Outlook Calendar add-on allows you to get a real-time two-way synchronization between Bookly Calendar and Outlook Calendar. With this connection, you can keep all your calendar data in sync to never miss an important appointment and avoid double bookings.

Setup and configuration

1. Purchase, download and activate the 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 will not work with your website if there is no valid SSL certificate installed on your web server.

1. Navigate to the Microsoft App Registration Portal and sign in with either a personal or work or school Microsoft account.

2. Choose Add an app. Enter a name for the app and choose Create application. The registration page displays, listing the properties of your app.

3. Copy the Application ID. You'll use it in the Application ID field.

4. Under Application Secrets, choose Generate New Password. Copy the app secret from the New password generated dialog box before closing it.


You'll use it in the Application secret field.


5. Under Platforms, choose Add Platform, and select Web.


In Redirect URLs enter the Redirect URI found on Settings > Outlook Calendar in Bookly.


6. Under Microsoft Graph Permissions, choose Add next to Delegated Permissions, and select Calendars.ReadWrite in the Select Permission dialog box. Close it by clicking Ok


7. Save the changes.

3. Go to Staff Members, select a staff member, click edit_staff_button.png > Details. Click Connect.


4. Choose from 3 modes of Outlook Calendar synchronization.

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 in Bookly will automatically appear in your Outlook Calendar. Events that were initially created in Outlook Calendar will not be copied and displayed in your Bookly Calendar. Outlook Calendar events will be taken into account when offering available time slots to clients in your booking form. So if you have an event in Outlook Calendar, then the corresponding time slot won’t be available for booking because Bookly will consider this time slot as busy.
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 selected Two-way sync mode, in the Sync appointments history field, you can specify how many days of past calendar data you wish to sync. For example, if you enter 1 in this field, both calendars will sync appointments history starting from yesterday.

Note: Initial sync may take a long time depending on the number of events to be synchronized.

6. Limit number of fetched events – allows you to limit the number of fetched events as too many events in Outlook calendar may lead to a lack of memory in PHP when Bookly tries to fetch all events.

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

Template for event title – choose details for Outlook Calendar event description that is created via Bookly. Available codes are {service_name}, {staff_name} and {client_names}.

Appointment section – use available shortcodes for the appointment-related information that will be displayed in Outlook Calendar.

Customer section – use available shortcodes for the customer-related information that will be displayed in Outlook Calendar.


Manual synchronization

You can force new sync by clicking on the Outlook Calendar button on the top right of the Bookly Calendar.



Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk