Back to Google Calendar Guides

This guide applies to:

  • Basic Edition
  • Plus Edition
  • Pro Edition
  • Business Edition

Introduction

To start syncing with Google Calendar, you’ll need to collect the Client ID and Client Secret from your Google API.

Our other guide covers enabling and using the Google Calendar Sync with your Appointments and Booking Calendar: Syncing with Google Calendar.

This process changes all the time. We do our best to keep this up to date, but there’s usually no warning or notification that the process has changed.

Guide Last Updated: October 13th, 2022


Video Walkthrough of the Entire Setup Process

Video Last Updated: March 30th, 2022


Open the Google Developer APIs and Services Dashboard

Go to the Google Developer APIs and Services Dashboard.

Make sure you log in to the Google account you’d like to sync with. You may also need to accept the Google Cloud Platform Terms of Service.

Accepting terms of service

1. Create a New Project

Once you’re on the dashboard, create a new project or choose an existing one. Creating a new project may take a moment. You may have to refresh the page to see your new project.

If you created a new project, you can use the following settings:

  • Name it “Booking Calendar Sync”,
  • and leave the Location set to No Organization.

Google Suite users can proceed with using their organization name as the Location. Can’t click on any organizations? Go to our Can’t Create a Project section.

Go back to the APIs and Services Dashboard.

Creating a new project for syncing SSA with Google Calendar

Alternate Screen After Creating a New Project

If you see this screen after starting a new project, click on the Explore and enable APIs option under the Getting Started section.

Clicking the Explore and enable APIs option

Can’t Create a New Project?

Only the domain owner can create a new Google Cloud Platform Project. If you can’t create a new project, contact the domain owner to create the project for you and add you as a collaborator to the project.

Here are some guides to help you get this sorted out:


2. Searching the API Library

Inside the Dashboard, press the button that says Library on the left-side panel. That should take you to the Google API Library.

In the Google API Library, search for “Calendar”. Select the Google Calendar API option.

Within the Google Calendar API page, click the Enable button to add the Google Calendar API to your project.

Searching for the Google Calendar API

3. Creating Credentials

The SSA plugin is self-hosted, meaning our company never accesses your data. This app is set up as your own, where your website is the host, and you’re technically the developer for this Google App.

From here, we can start the path to creating the API credentials. Select the Create Credentials button.

Screenshot depicting where the Create Credentials button is.
Clicking on Create Credentials in the Google API Dashboard After Enabling the Google Calendar Sync API

3A. Credential Type

Select the Google Calendar API from the Select an API dropdown. A set of radio buttons will appear; click on the User data option. Click Next.

Selecting the Credential Type and Data Access permissions in the Google API Dashboard for creating the google calendar client id.
Selecting the Credential Type and Data Access permissions in the Google API Dashboard

3B. OAuth Consent Screen

Fill in the following fields:

App Information:

  • App name: “Booking Calendar Sync”
  • User Support email: Use your email address

Developer Contact Information:

  • Email Addresses: Use your email address

Click Save and Continue.

OAuth Consent Screen Setup page on the Google API Dashboard
OAuth Consent Screen Setup Google API Dashboard

3C. Adding the Scope

Select the Add or Remove Scopes button.

Add only the Google Calendar API with the …auth/calendar scope, use search filter to search for “Calendar”. After selecting the scope scroll to the end and select Update.

Click Save and Continue.

Selecting the Google Calendar API scope from the Google API Dashboard

3D. OAuth Client ID Application

Fill in the following fields:

  • Application Type: select Web application
  • Name: Type in something like “Booking Calendar Sync”
  • Authorized redirect URLs: enter your website’s URL with the https:// and don’t include any subdomains.

When you’re done, click Create.

OAuth Client ID Creation on the Google API Dashboard for creating the google calendar client id.
OAuth Client ID Creation on the Google API Dashboard

3E. Your Credentials

We don’t have to copy the credentials from here yet; we still need to make some adjustments to our OAuth Consent Screen.

Go ahead and click Done.


4. Last Adjustments to OAuth Consent Screen (Don’t Skip!)

Select the OAuth Consent Screen tab. We’ll need to double-check the following:

  • External vs. Internal User Types
  • Publishing Status

4A. External vs. Internal User Type

External vs. Internal, more information here:

  • External apps also allow users outside your organization (@your_organization.com) to connect SSA to their personal Google Calendar. Available to any test user with a Google Account. 
  • Internal apps allow only users within your organization (@your_organization.com) to connect SSA to their personal Google Calendar. 

Please select External unless you own a Google Suite or Workspace account and plan to use your custom email address to sync to SSA.

4B. Publishing Status (Only if selected External in 4A)

By default, the Publishing Status will be set to Testing. We need to make sure this is set to In Production. Click on Publish App.

This should show you a pop-up with some warnings. Click Confirm on the pop-up.

Since this is for personal use, you do not have to verify the app or make a Youtube video. YOU DO NOT HAVE TO PREPARE FOR VERIFICATION.

Adjusting the OAuth Consent Screen in the Google API Dashboard to In Production and External
Adjusting the OAuth Consent Screen in the Google API Dashboard

5. Collecting the OAuth Client ID and Client Secret and Add to SSA

Now, we’ll be able to collect the Client ID and Client Secret for the Simply Schedule Appointments sync settings.

Go to Credentials from the left-side menu.

Click on the Client ID Name in the OAuth 2.0 Client IDs table. You should see your Client ID and Client secret in the top-right corner of the page.

Adding the Client ID and Client Secret to SSA

Paste your Client ID and Client Secret to the Google Calendar Sync settings in Simply Schedule Appointments. Click Save and Authorize.

Google will now ask permission for Simply Schedule Appointments to access your calendar. Go through those prompts to accept the permissions.

How to resolve 400 redirect_uri_mismatch errors

Bypassing “This app isn’t verified” message

If you choose the External app type, you may see a screen that says This app isn’t verified. To bypass this, click on the Advanced link and then the link that says Go to yoursite.com (unsafe). That should allow you to see the permission prompts.

Learn more about the “This app isn’t verified” error and why it won’t affect Google Calendar Sync.

Pasting the Client ID and Secret and accepting Google’s permissions.

6. Finish Setting Up Your Appointment Types (Required)

After you have set up your Google Calendar client id, your Simply Schedule Appointments calendar syncs with Google Calendar. Now, finish setting up Google Calendar in the Appointment Type settings.


Still stuck?

File a support ticket with our five-star support team to get more help.

File a ticket

  • Please provide any information that will be helpful in helping you get your issue fixed. What have you tried already? What results did you expect? What did you get instead?
  • This field is for validation purposes and should be left unchanged.


Related Guides