Aurinko
Aurinko websiteAurinko blogAPI ReferenceContact Support
Aurinko API
Aurinko API
  • Getting started
    • What is Unified Mailbox API?
    • Getting started with Aurinko
    • Get your developer API keys
    • Adding Aurinko to Google Workspace allowlist
    • Bubble.io plugin
    • Team members and roles in applications
  • Unified APIs
    • Email API
    • Calendar API
    • Contacts API
    • Tasks API
    • Webhooks API
      • Configuring Pub/Sub for Gmail API Webhooks
    • Direct API
  • Authentication
    • OAuth Flow
      • Account OAuth Flow
      • User ОАuth Flow
      • Service Account OAuth Flow
    • Authentication scopes
    • Authorized return URLs
    • Google OAuth setup
    • Office 365 OAuth setup
    • ZOHO OAuth setup
    • Service accounts
      • Setting up G Suite service account
      • Setting up Office 365 daemon app registration
  • Scheduling
    • Create your first appointment booking page
    • Calendar Booking Page
    • Booking API
    • Group Booking API
  • Workspace Addons
    • Outlook addins
      • Create your first Outlook addin
      • Office 365: Installing Outlook addin
    • Microsoft Teams apps
      • Microsoft Teams bot setup
      • Create your first MS Teams app
      • Installing MS Teams app
    • Chrome Extensions with Google authentication
    • Google Workspace Add-Ons
  • Dynamic API
    • What is Dynamic (Virtual) API?
    • Getting Started with Dynamic API
Powered by GitBook
On this page
  • Create a Google Project
  • Enable APIs
  • Configure OAuth consent screen
  • Create an OAuth credential
  • Configure Aurinko to use your Google OAuth credentials
  1. Authentication

Google OAuth setup

Set up Google OAuth by creating a project and client ID in the Developer Console. Enable required APIs and configure your app for Aurinko.

PreviousAuthorized return URLsNextOffice 365 OAuth setup

Last updated 5 months ago

In order to connect Google accounts to Aurinko through OAuth2 authentication you'll need to create your own Google Project and OAuth client ID. You will configure Aurinko to use this client ID. If you have any trouble creating a Google Project and OAuth client ID, get in touch with and we'd be happy to help you out!

Create a Google Project


To get started, head over to . You will be prompted to log in with a Google account if you're not already logged in with one. If you don't have a Google account, you can create one at .

Use the selector at the top (next to the Google logo) and click the 'NEW PROJECT' button in the popup window that opens.

Name your project and click "CREATE".

It may take up to a minute or two for Google to finish creating the project.

Enable APIs


Click the "ENABLE APIS AND SERVICES" button.

You'll be presented with the following search box:

Type "gmail" into the search box and click on the "Gmail API" card once it appears.

Click the large blue "ENABLE" button next to the Gmail logo.

You'll find yourself on the following page. Click the search box in the center of the top bar.

Type "calendar" and click on "Google Calendar API" once it appears.

Click "ENABLE" for the Google Calendar API.

In the similar manner find and enable Contacts API, Google People API, and Tasks API.

Configure OAuth consent screen


The last step to do in the Google Developer Console is to create a credential for OAuth, starting with configuring the consent screen. Click the "CREATE CREDENTIALS" button.

On the next screen, click "client ID".

Then click "Configure consent screen".

Choose "Internal" or "External" user type. An "Internal" user type Google application will only allow access to users from your organization ( @your-organization.com). This type of application allows you to entirely skip the App Verification and Security Review processes required by Google for public-access applications, but limits which accounts can authenticate to your application.

On the following page, fill out the "Application name" field.

You'll need to determine what Google scopes you add to your consent screen based on your application's behavior. Please reference this mapping to see how Aurinko scopes will map to Google scopes during the authentication process:

Aurinko scope
Google API permission

Mail.ReadOnly

Mail.ReadWrite

Mail.Draft

Mail.Send

Calendar.ReadOnly

Calendar.ReadWrite

Contacts.ReadOnly

Contacts.ReadWrite

Tasks.ReadOnly

Tasks.ReadWrite

Then add all required Google scopes, i.e. gmai.modify, gmail.send, calendar, contacts, tasks.

Finally, add your app's domain to the "Authorized domains" field.

Scroll down to the bottom of the page and click the blue "Save" button!

Create an OAuth credential


Click "Create credentials" and select "OAuth client ID" from the drop-down menu.

Fill out the form choosing the appropriate application type based on your application, and be sure to read the article regarding redirect URIs.

Then click the blue "Create" button at the bottom of the screen.

You'll be presented with a page that shows your new OAuth client ID and Secret. Keep the page open, as you'll need the credentials in the next step.

Configure Aurinko to use your Google OAuth credentials


Select your app at the top, choose Settings menu and switch to the GOOGLE tab.

Copy-paste your Google OAuth client ID and Secret from the Google Developer Console and click "Save".

You are now all set to start connecting Google accounts to Aurinko!

Head on over to and log in.

Aurinko portal
https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.compose
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/contacts.readonly
https://www.googleapis.com/auth/contacts
https://www.googleapis.com/auth/tasks.readonly
https://www.googleapis.com/auth/tasks
support@aurinko.io
https://console.developers.google.com/
https://accounts.google.com/signup/