Google — record connection tracking event

Overview

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.

Prerequisites

• A bearer token in the Authorization header, OR an invite hash, OR the public connect-page company_id_hash, OR source=registration (anonymous signup wizard).

Base URL

Endpoint

POST /api/v1/google/connection-event

Authentication

• A bearer token is optional here. Send one to act as a signed-in user, or supply one of the documented alternatives instead.

• Use a bearer token.

• OR use an invite hash.

• OR use the public connect-page company_id_hash.

• OR use source=registration (anonymous signup wizard).

Rate limit

• 30 requests/min per IP (public).

Request body

{
  "event": "oauth.started",
  "source": "settings",
  "store_review_site_id": "<storeReviewSiteId>"
}

How it works

Returns {data:{status:"recorded"}} on success; on an internal tracking error it swallows the failure and returns {data:{status:"skipped"}} so the SPA is never blocked. Validation errors and authentication failures return appropriate non-2xx status codes.

Response

200 Recorded · 200

{
  "data": {
    "status": "recorded"
  }
}

200 Skipped (tracking error swallowed) · 200

{
  "data": {
    "status": "skipped"
  }
}

422 Validation error · 422

{
  "message": "The selected event is invalid.",
  "errors": {
    "event": [
      "The selected event is invalid."
    ]
  }
}

Errors

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/google/connection-event" \
  --header 'Authorization: Bearer <bearer-token>' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"event": "oauth.started", "source": "settings", "store_review_site_id": "<storeReviewSiteId>"}'