listingsAPI

Name	Type	Required	Description
connectedAccountId	string	required	UUID of the connected Google account (from the list connected accounts endpoint).

Name

Type

Required

Description

connectedAccountId

string

required

UUID of the connected Google account (from the list connected accounts endpoint).

Responses

200Array of GMB folder objects.

{
  "data": {
    "getFoldersUnderGoogleAccount": [
      {
        "folderId": "accounts/104890024806530350198",
        "folderName": "Aniruddha Basu",
        "locationCount": null
      }
    ]
  }
}

401Unauthenticated — missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

Returns the folders (also called groups or account groups) in Google Business Profile that the connected Google account can access. Folders are how GBP organizes business listings under an account; each carries a folderId, a folderName, and — when Google reports it — a locationCount.

Use case — place a new listing in the right folder. Before calling the create-GMB-listing endpoint, list the account's folders and let the customer pick one. Pass the chosen folderId (the accounts/{id} string, used verbatim) so the new listing is created inside that folder rather than at the account root.

Use case — reconcile against a customer's GBP structure. Multi-location brands frequently split listings across folders. Fetch the folder list to render the customer's real GBP hierarchy in your UI and confirm you are syncing into the folder they expect. Note locationCount may be null when Google does not return a count for the folder, so treat it as optional rather than authoritative. This endpoint requires a Google-type connected account; the path is only valid for GoogleAccount connections.

List GMB folders for a connected account

Parameters

Path

Responses