We're experiencing temporary database issues. Please try again.

Google OAuth Configuration Guide

Setting Up Flow for Your Account

Flow works with your Google Calendar and Tasks to optimize your time management. To authorize Flow, you'll need to configure your Google Cloud project with the correct OAuth settings.

Step 1: Copy Your Redirect URIs

IMPORTANT: You MUST add BOTH URIs below to your Google Cloud Console!

Replit generates a new URL each time your app is restarted or redeployed, and your app also uses flow-planner.com. Add BOTH to work reliably.

1. Current Replit URI:

2. Custom Domain URI:

Both URIs must be entered exactly in your Google Cloud Console settings under authorized redirect URIs, or you'll keep seeing the "Access blocked: This app's request is invalid" error.

Your Current Client ID:

99863485....com

Verify this matches your Google Cloud Console OAuth 2.0 Client ID.

Step 2: Configure Google Cloud Console

  1. Create a Google Cloud Project (if you don't have one already)
    • Go to the Google Cloud Console
    • Click on the project dropdown near the top of the page and click "New Project"
    • Name your project (e.g., "Flow Time Management") and click "Create"
  2. Configure OAuth Consent Screen
    • In your project, navigate to APIs & Services > OAuth consent screen
    • Select the appropriate user type (External or Internal)
    • Fill in the required app information (App name, User support email, etc.)
    • Add the following scopes:
      • https://www.googleapis.com/auth/calendar.events
      • https://www.googleapis.com/auth/userinfo.profile
      • https://www.googleapis.com/auth/tasks
      • https://www.googleapis.com/auth/userinfo.email
      • openid
    • If your app is in testing mode, add your email address as a test user
  3. Update your OAuth Credentials with the NEW Redirect URI
    • Navigate to APIs & Services > Credentials
    • If you already have credentials:
      • Find your existing OAuth 2.0 Client ID in the list
      • Click the pencil icon to edit it
      • Under "Authorized redirect URIs", add the new URI shown above
      • You can keep the old URI too - this makes your app work with both old and new Replit URLs
    • If this is your first time:
      • Click "Create Credentials" and select "OAuth client ID"
      • Select "Web application" for the Application type
      • Under "Authorized redirect URIs", click "Add URI" and paste your exact Redirect URI shown above
    • Double-check that the URI is entered correctly without any trailing spaces or slashes
    • Click "Save" (or "Create" if making new credentials)
  4. Enable Required APIs
    • Navigate to APIs & Services > Library
    • Search for and enable the following APIs:
      • Google Calendar API
      • Google Tasks API
      • Google People API (for user profile information)

Step 3: Update Your Flow Application

Once you've completed the Google Cloud configuration, you'll need to add your Client ID and Client Secret to your Flow application. Administrators can set these via environment variables.

Important Notes
  • The redirect URI must match exactly as shown above - even a trailing slash difference will cause an error.
  • New Google Cloud settings can take up to 5 minutes to propagate.
  • If you receive a "This app is not verified" warning, you can safely click "Continue" during development.
  • For production use, complete Google's verification process to remove the unverified app warning.