v2

latestOpenAPI 3.1.02026-08-075421692.0 MB

Connect

Select GBP location

Complete the headless GBP flow by saving the user's selected location. The pendingDataToken is returned in your redirect URL after OAuth completes (step=select_location). Tokens and profile data are stored server-side, so only the pendingDataToken is needed here. Use X-Connect-Token header if connecting via API key.

post/v1/connect/googlebusiness/select-location

Request body

profileIdstring required

Profile ID from your connection flow

locationIdstring required

The Google Business location ID selected by the user

accountIdstring

Optional but recommended. The Google Business Account resource name ("accounts/123") that owns the selected location (returned per-location by GET /v1/connect/googlebusiness/locations). When provided, the location is resolved directly instead of by enumerating the account, which is required for accounts that own many locations. Omit only for small accounts.

pendingDataTokenstring required

Token from the OAuth callback redirect (pendingDataToken query param). Tokens and profile data are retrieved server-side from this token.

redirect_urlstring uri

Optional custom redirect URL to return to after selection

Response

Google Business location connected successfully

messagestring

redirect_urlstring

Redirect URL if custom redirect_url was provided