List GBP locations

For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.

GET /v1/connect/googlebusiness/locations

For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.

Parameters

• profileId (query, string) — Profile ID from your connection flow. Required for auth validation when provided.

• pendingDataToken (query, string) — Token from the OAuth callback redirect. Preferred over tempToken because it preserves server-side token storage. One of pendingDataToken or tempToken is required.

• tempToken (query, string) — Legacy. Direct Google access token. Use pendingDataToken instead when available.

Responses

200 — List of Google Business locations available for connection

• locations (array)

400 — Missing required parameters (profileId or tempToken)

401

500 — Failed to fetch locations (e.g., invalid token, insufficient permissions)

• error (string)