Unified.to
All articles

How to set up Google Business Profile API access and get OAuth 2 credentials


August 31, 2026

💡 Note that Google Business Profile uses the https://www.googleapis.com/auth/business.manage scope, which Google classifies as Sensitive. You need to contact Unified's Support to setup a CNAME for the API URL in order to get your App approved by Google.
Check How to set up a custom API URL.

⚠️ Enabling the APIs is not enough. Until Google approves your Application for Basic API Access, your project's quota for the Business Profile APIs stays at 0 requests per minute and every call fails with a 429. Submit that form as early as possible — Google's review can take several days to a few weeks.

  1. Prerequisites
    • A Google account with owner or manager access to the Business Profile(s) you want to connect.
    • A verified, active Business Profile. Google's review expects the profile to have been active for at least 60 days and to have a website listed on it.
    • Review Google's Prerequisites page before you apply.
  2. Create a Google Cloud project
    • Go to the Google Cloud Console and sign in with that Google account.
    • Click the Select a project dropdown at the top of the page and choose New Project.
    • Give your project a name and click Create.
    • Copy the Project number and Project ID from the Cloud Console dashboard — you need them in the next step.
  3. Submit the Application for Basic API Access
    • Open the Application for Basic API Access form.
    • Fill in the requested information:
      • The Project ID and Project number from step 2
      • The email address of an owner or manager of the Business Profile
      • Your company name, website and a description of how you will use the API
    • Submit the form. Google sends a follow-up email once the request has been reviewed.
    • You do not have to wait for approval to continue — steps 4 to 8 can be completed right away.
  4. Enable the Business Profile APIs
    • In the Google Cloud Console, make sure your project is selected.
    • Navigate to APIs & Services > Library and enable each of the following:
    • These four are the only APIs Unified calls. Google documents several others (Notifications, Verifications, Q&A, Place Actions, Lodging) — you do not need them for a Unified connection.
    • The Google My Business API only becomes visible in the Library after your Basic API Access request is approved. If you cannot find it, come back to this step once you receive Google's approval email.
  5. Configure the OAuth Consent Screen
    • In the Google Cloud Console, go to Google Auth Platform.
    • Fill in what is asked and click Create.
    • Go to Auth Branding and fill in the required information, including your app name, support email, authorized domain and privacy policy URL.
  6. Scopes
    • Go to Auth Data Access.
    • Add https://www.googleapis.com/auth/business.manage, plus openid, userinfo.email and userinfo.profile.
    • The exact list of scopes used by Unified can always be found in the Google Business Profile integration in the Unified App.
    • Note that business.manage is a Sensitive scope, so you need to contact Unified's Support to setup a CNAME for the redirect URL in order to get your App approved by Google.
    • Review the information and click Save and Continue through the steps.
  7. Create OAuth 2.0 Credentials
    • Go to Auth Clients in the Google Cloud Console.
    • Click on + Create Client and select Web application.
    • Configure the authorized redirect URI. Get the correct value from the Google Business Profile integration in the Unified App.
    • Copy your Client ID and Client Secret.
  8. Publish your Application
    • Go to Auth Audience and click on Publish app.
    • Because you are using a Sensitive scope, Google will require verification of your app. Until it is verified, your consent screen will show the unified.to name, which is inferred from the redirect URL — this is what the CNAME in step 1 solves.
  9. Configure your Unified integration
    • In the Google Business Profile integration in the Unified App, enter:
      • The OAuth client's Client ID
      • The OAuth client's Client Secret
    • Save the integration. You are now ready to authorize a Google Business Profile connection.
  10. Verify that your API access was approved
    • Go to IAM & Admin > Quotas in the Cloud Console and filter by one of the Business Profile services, for example mybusinessaccountmanagement.googleapis.com.
    • A Requests per minute limit of 0 means your Basic API Access request has not been approved yet.
    • A limit of 300 means you have been approved and your connection will work.

Troubleshooting

SymptomCause and fix
429 RATE_LIMIT_EXCEEDEDQuota exceeded for quota metric 'Requests' and limit 'Requests per minute'Either your Basic API Access request is still pending (quota is 0 QPM), or you are exceeding the default 300 QPM. Check the quota as described in step 10, and request a quota increase from the same Quotas page if you legitimately need more.
invalid_client when authorizing a connectionThe Client ID or Client Secret in the Unified integration does not match the OAuth client, or the redirect URI in Google does not match the one shown in the integration. Re-copy all three values.
403 PERMISSION_DENIED or an empty list of accountsThe Google account used to authorize does not have owner or manager access to the Business Profile, or the required API from step 4 is not enabled on the project.
The consent screen shows unified.to instead of your app nameYour app has not been verified by Google yet. Contact Unified's Support to setup a CNAME for the API URL, then submit your app for verification. See How to set up a custom API URL.
An API cannot be found in the Cloud Console LibraryThe Google My Business API is only exposed once Google approves your Basic API Access request. Wait for the approval email and enable it then.
All articles