Google — record connection tracking event

Record a browser-side step of the Google Business Profile connection funnel (sign-in clicked, consent denied, callback error, locations listed) for connection reporting. Fire-and-forget: The endpoint accepts only client-reportable funnel events — connection state changes (connected/disconnected) are recorded server-side only and cannot be fabricated here.

Auth

  • Auth-optional. Bearer token OR an invite hash OR the public connect-page company_id_hash OR source=registration (anonymous signup wizard).

Rate limit

  • 30 requests/min per IP (public).

Body

FieldTypeRequiredNotes
eventstringRequiredOne of: oauth.started, oauth.denied, oauth.callback_error, locations.fetched, locations.none_found.
sourcestringRequiredOne of: invite_link, connect_google_page, registration, settings, debugger.
store_review_site_idintegerOptionalBinds the event to a row (must be accessible via hash/token).
hashstringOptionalInvite hash [store_id, 15]; grants access without a token.
company_id_hashstringOptionalHashid of the account (public connect page).
messagestring (≤500)OptionalError detail returned by Google, if any.
accounts_countinteger (≥0)OptionalAccounts listed.
locations_countinteger (≥0)OptionalLocations listed.

Behaviour

  • Always 200. Returns {data:{status:"recorded"}}; on an internal tracking error it swallows the failure and returns {data:{status:"skipped"}} so the SPA is never blocked.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
string
string
Responses

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json