> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Google Business Profile

> Manage your local business listing from Hiveku

Connect Google Business Profile (GBP) to pull insights, post updates, and respond to reviews for your local business listings — all from within Hiveku.

<Info>
  Before you start: [Set up a Google Cloud OAuth app](/how-tos/google-oauth-app) and enable both required APIs (listed below).
</Info>

## Before You Start

* A [Google Cloud OAuth app](/how-tos/google-oauth-app) registered in Hiveku's **Settings > OAuth Apps**
* **Two APIs enabled** in your Google Cloud project:
  * **My Business Account Management API**
  * **Business Profile Performance API**
* A Google account that owns or manages at least one verified location at [business.google.com](https://business.google.com)

<Warning>
  Brand-new GBP listings must be verified by Google (postcard, phone, or video) before the API can return data for them. If your location is pending verification, API calls won't find it.
</Warning>

## Connect via OAuth

<Steps>
  <Step title="Open the integration">
    Go to **Marketing > SEO > Add Connection > Google Business Profile**.
  </Step>

  <Step title="Select your Google OAuth app">
    Pick the Google app you registered. If you haven't created one yet, start with [Set up a Google Cloud OAuth app](/how-tos/google-oauth-app).
  </Step>

  <Step title="Authorize with Google">
    Click **Authorize**. You'll be redirected to Google, sign in with the account that manages your business, and grant the scope:

    ```
    https://www.googleapis.com/auth/business.manage
    ```
  </Step>

  <Step title="Pick a location">
    Hiveku auto-discovers every GBP account and location the Google user manages. A modal opens listing them — pick the location to connect.

    Behind the scenes, locations are identified as:

    ```
    accounts/123456789/locations/123456789
    ```

    You don't normally need those IDs — the UI handles the selection.
  </Step>

  <Step title="Confirm the connection">
    Hiveku saves the location name and metadata. It appears in your SEO dashboard with local insights.
  </Step>
</Steps>

## What You Can Do

Depending on your Hiveku plan and the features enabled, a connected GBP location lets you:

* **View insights** — impressions, direction requests, phone calls, website visits
* **Post updates** — offers, events, announcements
* **Respond to reviews**
* **Manage business info** — hours, photos, attributes (where feature-gated)

## Connect Multiple Locations

If you manage a chain or multi-location business, repeat the flow for each location. Each becomes its own connection in Hiveku.

<Tip>
  Running an agency managing many GBP listings across multiple Google accounts? Connect each Google account separately — GBP doesn't expose "partner managed" access across accounts the way Google Ads does with MCC.
</Tip>

## Verify the Connection

* The location name appears on the SEO dashboard
* Local insights start populating within a few minutes
* If you post an update from Hiveku, it should appear on the live Business Profile within a few minutes (Google sometimes queues posts)

## Troubleshooting

<AccordionGroup>
  <Accordion title="No locations show in the picker">
    The authorized Google account doesn't own or manage any verified Business Profile locations. Go to [business.google.com](https://business.google.com), confirm the account has access, and make sure each location is **Verified** (not pending). Then disconnect and reconnect.
  </Accordion>

  <Accordion title="'business.manage not granted' error">
    The scope wasn't consented during the authorization flow. Reconnect and make sure you grant all requested permissions. Also check that `business.manage` is listed on your OAuth consent screen scope list.
  </Accordion>

  <Accordion title="'API not enabled' error">
    GBP requires **two** APIs enabled in your Google Cloud project. Go to **APIs & Services > Library** and enable both:

    * My Business Account Management API
    * Business Profile Performance API

    Wait a minute after enabling, then retry.
  </Accordion>

  <Accordion title="Location exists but API says 'not found'">
    New or recently migrated GBP listings need to be fully verified with Google before the API can return them. Check verification status at [business.google.com](https://business.google.com). Postcard and phone verification typically clear within a few days; video verification is faster.
  </Accordion>

  <Accordion title="Insights look incomplete or delayed">
    GBP insights data has inherent delays (typically 1-3 days lag for some metrics). Confirm the same data is visible in your Business Profile dashboard — if it's missing there too, it's a Google data-pipeline delay, not a connection problem.
  </Accordion>
</AccordionGroup>

## What's Next?

<CardGroup cols={2}>
  <Card title="Connect Search Console" icon="magnifying-glass" href="/how-tos/connect-gsc">
    Pair local data with organic search
  </Card>

  <Card title="SEO" icon="chart-line" href="/how-tos/seo">
    Build out the full SEO stack
  </Card>
</CardGroup>