Google OAuth App Setup

This guide walks you through creating your own Google OAuth app so you can use custom OAuth credentials with PortEden for Google Calendar and Gmail integration. By bringing your own OAuth app, you have full control over consent branding, scopes, and user access.

1. Create a Google Cloud Project

Head over to the Google Cloud Console and sign in with your Google account. From the project dropdown at the top of the page, click New Project, give it a name (e.g. "PortEden Integration"), and click Create.

If you already have a project you'd like to use, simply select it from the dropdown instead.

2. Enable the Required APIs

Navigate to APIs & Services > Library in the Cloud Console. Search for and enable each of the following APIs:

API	Used for
Gmail API	Reading, sending, and managing emails through PortEden
Google Calendar API	Listing calendars, reading and creating events, managing RSVPs

Tip

Click each API name in the Library, then click the Enable button. You'll see a green checkmark once the API is active.

Go to the OAuth consent screen page. Google will ask you to choose a User type:

InternalGoogle Workspace only

Choose this if your organization uses Google Workspace. Only users within your organization will be able to authorize the app. No Google verification is required.

Externalpersonal Gmail / multi-org

Choose this if you don't have Google Workspace or need users from outside your organization. After creating the app, keep it in "Testing" publishing status and add your users as test users (up to 100 users). No verification is required while in Testing mode.

Tip

Keeping your app as Internal or in Testing mode means you can skip Google's app verification process entirely. This is the recommended approach for personal and team use.

Fill in the required fields — an App name and a Support email — then click Save and Continue.

4. Configure Data Access (Scopes)

On the Data Access page in your OAuth consent screen settings, click "Add or Remove Scopes" and add each of the following scopes:

Scope	Purpose
userinfo.email	Identify the user's email address
userinfo.profile	Retrieve basic profile information
calendar.events	Read and write calendar events
calendar.readonly	Read-only access to calendars and event lists
gmail.modify	Read, send, and manage email messages

Note

You can search for each scope by name in the scope picker, or paste the full URI directly into the filter field. For example: https://www.googleapis.com/auth/calendar.events

5. Create OAuth Credentials

Navigate to the Credentials page and click + CREATE CREDENTIALS > OAuth client ID.

Set Application type to Web application.
Give it a descriptive name (e.g. "PortEden OAuth").
Under Authorized redirect URIs, click + Add URI and enter:

Redirect URI

https://my.porteden.com/calendar-providers/oauth-callback

Click Create to generate your credentials.

6. Copy Your Client ID & Secret

After clicking Create, a dialog will display your Client ID and Client Secret. Copy both values.

Note

You can always retrieve these later by going to the Credentials page and clicking on your OAuth client name under "OAuth 2.0 Client IDs".

7. Connect to PortEden

Open your PortEden dashboard and navigate to Settings > Integrations. Paste your Client ID and Client Secret into the Custom OAuth fields, and you're all set.

Tip

Once connected, PortEden will use your custom OAuth app for all Google Calendar and Gmail interactions — giving you full ownership of the credentials and consent experience.