ZEzernio
Connect

Select Google Business Profile location

Changed on

Complete the headless Google Business Profile 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

Request body

profileIdstring required

Profile ID from your connection flow

locationIdstring

The Google Business Profile location ID selected by the user. Send this or locations, not both.

accountIdstring

Optional but recommended. The Google Business Profile 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 Profile location connected successfully

messagestring
redirect_urlstring

Redirect URL if custom redirect_url was provided

accountsobject[]

locations with two or more distinct entries only. The connected accounts, same shape as account. The redirect_url then carries accountIds (comma-separated) and accountId of the first.

Changes

  • d568bb00ed73Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

    • warning

      added the new account enum value to the / response property for the response status