Skip to content

Google Business Profile OAuth setup

Google Business Profile OAuth setup begins with the provider application. Configure a Google Cloud OAuth client for a connected Google Business Profile. Project approval and API access are prerequisites, even when the OAuth client settings are complete.

Callback URL

Register {{API_BASE_URL}}/v1/connect/googlebusiness/callback in the provider’s Authorized redirect URIs. Configure the API origin for your environment and keep the callback path unchanged.

Configure Google Cloud

  1. Request and receive access to the Google Business Profile APIs.
  2. Create or select a project in Google Cloud Console and enable the Business Profile APIs it uses.
  3. Set up the OAuth consent screen with the app name, website, privacy policy and terms.
  4. Create an OAuth client with application type Web application. Add the callback under Authorized redirect URIs.
  5. Copy the client ID and client secret.

Permissions and access restrictions

Use the permission identifiers listed in the table. Google Business Profile has no sandbox. Google must approve the project before its APIs become available; a saved client alone does not grant that approval.

Save the app before connecting an account

Open Integrations → Apps (BYOK) → New app and select Google Business. Fill the client ID and client secret fields using the credential map, then save the app record. Begin a new integration, pick that saved app, and only then choose Google Business for account authorization. Selecting the app first binds the connection to the intended credentials.

Requested permission identifiers
Permission
https://www.googleapis.com/auth/business.manage

Request only the capabilities your product uses and complete the provider’s review requirements.

Credential field map
Provider valueBYOK field
Google client IDclient ID
client secretclient secret

Store the secret in the app record; do not include it in a shared callback URL.

OAuth callback URL
{{API_BASE_URL}}/v1/connect/googlebusiness/callback