Skip to main content
Google OAuth is part of the Formbricks Enterprise Edition

Google OAuth

Integrating Google OAuth with your Formbricks instance allows users to log in using their Google credentials, ensuring a secure and streamlined user experience. This guide will walk you through the process of setting up Google OAuth for your Formbricks instance.

Requirements

  • A Google Cloud Platform (GCP) account
  • A Formbricks instance running

How to connect your Formbricks instance to Google

1

Create a GCP Project

  • Navigate to the GCP Console.
  • From the projects list, select a project or create a new one.
2

Setting up OAuth 2.0

  • If the APIs & services page isn’t already open, open the console left side menu and select APIs & services.
  • On the left, click Credentials.
  • Click Create Credentials, then select OAuth client ID.
3

Configure OAuth Consent Screen

  • If this is your first time creating a client ID, configure your consent screen by clicking Consent Screen.
  • Fill in the necessary details and under Authorized domains, add the domain where your Formbricks instance is hosted.
4

Create OAuth 2.0 Client IDs

  • Select the application type Web application for your project and enter any additional information required.
  • Ensure to specify authorized JavaScript origins and authorized redirect URIs.
5

Save persistent configuration

Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in the configuration that creates your app containers. With Compose, reference protected .env values from the app’s environment block:
With Kubernetes, use your deployment’s Secret bindings. Keep credentials out of Git and shared logs. An export in a docker exec shell does not configure the running application or survive recreation.
6

Apply and verify

Recreate the app during your planned configuration window:
On Kubernetes, roll out the updated deployment through Helm or GitOps. Test Google sign-in in a fresh browser session and confirm the callback uses your public WEBAPP_URL.