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 how to enable and use 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: December 11th, 2021


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 login 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 making 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 setup 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.

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
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
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 a couple of 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:

  • Publishing Status
  • User Type (Optional)

4A. Publishing Status

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.

4B. User Type

External vs. Internal, more information here:

  • External apps allow users outside your organization (@your_organization.com) to also connect SSA to their personal Google Calendar. Available to any test user with a Google Account. 
  • Internal apps allows only users within your organization (@your_organization.com) to also 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.

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 accepting the permissions.

How to resolve 400 redirect_uri_mismatch errors

If you chose 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.

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

6. Finish Setting Up Your Appointment Types (Required)

Afterward, 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