1. Documentation /
  2. Introduction to WooCommerce Bookings /
  3. WooCommerce Bookings Settings /
  4. WooCommerce Bookings Custom Google Calendar Integration

WooCommerce Bookings Custom Google Calendar Integration

This document explains how to create a custom integration between Google Calendar and your site’s WooCommerce Bookings. The WooCommerce Bookings extension allows you to synchronize your Bookings with a Google Calendar and supports two-way syncing.

You can connect your Google Calendar using your own app credentials, following the steps below.

If you have a working connection but would like to switch to this method, please disconnect the other connection first.

Step 1: Google Cloud Console

↑ Back to top

To use this integration, go to the Google Developers Console.

Step 2: Create Project

↑ Back to top
  1. Go to Projects > Create Project button. A popup should appear and ask for a Project Name and Project ID. Enter your preferences.

2. Name your new project. For example, “My Bookings Connection”.

Step 3: Enable the Calendar API

↑ Back to top
  1. Once the project has been created, make sure it’s selected from the dropdown at the top-left of the screen.
  2. Then, from the menu on the right, select APIs and Services > Library.


3. Choose the Google Calendar API.

4. Then click on Enable.

Step 4: Create Credentials

↑ Back to top
  1. Clicking Enabled as illustrated above will take you to the screen from where you can create credentials.
  2. Select Go to Credentials from the top-right of the screen.
  1. Under Select an API select Google Calendar API
  2. Under What data will you be accessing? select User data
  3. Then click on the Next button
↑ Back to top
  1. The Next button above takes you to the next step with the OAuth Consent screen set up.
  2. The consent screen is the popup presented when you click on Connect in the Bookings Settings in your store under WP-Admin > Bookings > Settings > Calendar Integration.
  • App Name is for reference and will appear on the popup.
  • User support email is set by default to the account you’re logged in as (you may have other options in the dropdown list)
  • We suggest not to add an App logo. It may trigger your app needing a review by Google and can take up to 4-6 weeks (during which you will not be able to use it). Since this app is only used internally for connecting the site to the calendar, it’s recommended that you do not add one.
  • Developer Contact Info is required and can be the same as the above.
  • When you’re done, click Save and Continue.

Step 6: Scopes

↑ Back to top

The Scopes section can be left blank, as there’s nothing in this section that is required.

Scroll to the bottom of the section and click Save and Continue.

Step 7: OAuth Client ID

↑ Back to top

In the OAuth Clients ID section

  1. Set Application Type to Web Application.
  2. Set Name to a reference for yourself (it’s not publicly visible anywhere).
  3. Leave Authorized JavaScript origins blank.
  4. Set Authorized redirect URIs to https://example.com/wc-api/wc_bookings_google_calendar/ (replace example.com with the URL of your website).
  5. Click Create.

Step 8: Get Your Credentials

↑ Back to top

In this section, you are given an opportunity to copy your Client ID to the clipboard, or download your credentials as a JSON File. The JSON file contains a Client ID and Client Secret, which you will need to complete setup, in addition to other information that you will not need.

Click Done.

You can access the required credentials anytime by going to APIs and Services > Credentials, and clicking on the relevant OAuth 2.0 Client ID, from where you can copy the credentials (Client ID and Client secret) from the top-right of the screen.

If the publishing status of your app is set to Testing then you’ll need to add Test Users.

  1. Add at minimum your own email address. You can do so from under OAuth Consent Screen > Test Users.
  2. Click the Add Users button and type the email address of the account that’s allowed to use this application.

Step 9: Add Credentials to your website

↑ Back to top

With your credentials ready to copy, head to your store’s admin dashboard and navigate to Bookings > Settings > Calendar Connection. 

  1. In the Connect with a custom Google Calendar App section, paste the Client ID and the Client Secret in their respective fields.
  2. Next, at the bottom of the page, click the Save Changes button.
  3. Saving changes adds a new Connect with Custom Google App button below the credentials.

Step 10: Authorize with Google

↑ Back to top
  1. Clicking Connect with Custom Google App takes you to a different screen to choose a Google account.

2. There will be a warning about the app not being verified, you can read more about it here. Click Continue.


3. You will see a popup that reflects the information you entered in the Setup OAuth Consent Screen section to grant access to your calendar. Click Continue.

4. You will then be redirected back to your site and a Successfully authenticated message should be visible above the button that has now changed to read Disconnect.

Step 11: Set calendar and Sync Preference

↑ Back to top

You can follow the steps here to finish the setup and learn more about the integration with your Google Calendar.