post
https://production-api.shoutaboutus.com/api/v1/google/review-site/connect
Connect a Google Business Profile location to a store review site. Persists the account/location/place ids + token, sets sendto_scrapper=Y, url_status=enable, connection_status=connected; soft-deletes obsolete RD-scraped Google reviews for the (store, Google) pair (Google's own API becomes source of truth). And records a gbp_connection_events row (CONNECTED / RECONNECTED / ACCOUNT_SWITCHED). Emits audit STORE_REVIEW_SITE_OAUTH_CONNECTED (and GOOGLE_OAUTH_WIPED_RD_REVIEWS when rows are wiped).
Auth
- Auth-optional. Bearer token (api guard, scoped by an ownership check) OR an invite
hash(no token) whose encoded store must ownstore_review_site_id.
Rate limit
- 30 requests/min per IP (public).
Body
| Field | Type | Required | Notes |
|---|---|---|---|
store_review_site_id | integer | Required | Must exist; in caller scope (an ownership check) unless using hash. |
google_access_token_id | integer | Required | the Google connection's id from the token exchange. |
account_name | string (≤255) | Required | Google account resource, e.g. accounts/123. No angle brackets. |
location_name | string (≤255) | Required | Google location resource, e.g. locations/456. No angle brackets. |
google_place_id | string | Required | Google Place ID. |
mapsUri | url (≤2000) | Required | Google Maps URL → stored as review_site_url. |
newReviewUri | url (≤2000) | Required | Write-review URL → stored as landing_page_url. |
google_response | any | Optional | Raw Google API payload. |
force_update | integer (0,1) | Optional | Re-link even if a different location is already connected (wipes prior reviews). |
hash | string | Optional | Invite hash [store_id, 15]; grants access without a token, must match the row's store. |
Behaviour
- 200 on connect. 400 if the location belongs to a different location without
force_update, or (production) if the Google location is already linked elsewhere.
Errors: 422 on validation failure.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…