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
- Request and receive access to the Google Business Profile APIs.
- Create or select a project in Google Cloud Console and enable the Business Profile APIs it uses.
- Set up the OAuth consent screen with the app name, website, privacy policy and terms.
- Create an OAuth client with application type Web application. Add the callback under Authorized redirect URIs.
- 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.
| Permission |
|---|
| https://www.googleapis.com/auth/business.manage |
Request only the capabilities your product uses and complete the provider’s review requirements.
| Provider value | BYOK field |
|---|---|
| Google client ID | client ID |
| client secret | client secret |
Store the secret in the app record; do not include it in a shared callback URL.
{{API_BASE_URL}}/v1/connect/googlebusiness/callback