Save Google Business location (step 3 — Google path)

post

https://production-api.shoutaboutus.com/api/v1/signup/account/business

Completes self-service signup on the Google path. Call this after the user picks one of their Google Business Profile locations.

It attaches that location to the signup, resolves the city, state and country from the address, then provisions the account, its location, its store and its plan. Finally it marks the signup Active and returns the full signup snapshot.

The call is synchronous and runs inside a database transaction, so a failure at any step rolls the whole thing back and creates nothing.

Auth

Public — send no Authorization header. The signup_account_id identifies the in-progress signup.

Rate limit

10 requests/min per IP.

📘
Field naming. Most fields use snake_case, but mapsUri and newReviewUri are camelCase. That is deliberate: those two come straight from Google's Business Profile API, so this endpoint accepts them under Google's own names. Send them exactly as shown.

Body

Field	Type	Required	Notes
`signup_account_id`	integer	Required	The signup activation id.
`google_access_token_id`	integer	Required	the Google connection's `id` of the connected Google account.
`business_name`	string	Required	≤100 chars; no angle brackets.
`account_name`	string	Required	≤100 chars; Google account resource name.
`address1`	string	Optional	≤255 chars. Defaults to `Address Missing` when empty.
`address2`	string	Optional	≤255 chars.
`country_code`	string	Optional	ISO country code; when you omit it the store falls back to a default city.
`state`	string	Optional	Resolves the city row together with `country_code`/`city`.
`city`	string	Optional	Resolves the city row together with `country_code`/`state`.
`postal_code`	string	Optional	Defaults to `92014` when empty.
`google_place_id`	string	Required	Google Place ID.
`location_name`	string	Required	Google location resource name.
`mapsUri`	string	Required	Google Maps URI.
`newReviewUri`	string	Required	Google "write a review" URI.
`website_uri`	string	Optional	Business website URL.

Behaviour

200 returns the signup snapshot, now including a business object.
400 when the selected Google location has no city, state or country the platform can resolve.
500 when provisioning fails. The transaction rolls back, so no partial account is left behind.

This call also creates the account, location, store and plan records, queues the first review pull for the new store, and emails a referral notification when the signup came through a referral link.

🚧
The business.google_access_token field carries a live Google OAuth access token, which the signup wizard uses to read the user's Google locations from the browser. Treat it as a credential: do not log it, and do not persist it outside the signup session.

Errors: 422 on validation failure.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Save Google Business location (step 3 — Google path)

Auth

Rate limit

Field naming. Most fields use `snake_case`, but `mapsUri` and `newReviewUri` are `camelCase`. That is deliberate: those two come straight from Google's Business Profile API, so this endpoint accepts them under Google's own names. Send them exactly as shown.

Body

Behaviour

The `business.google_access_token` field carries a live Google OAuth access token, which the signup wizard uses to read the user's Google locations from the browser. Treat it as a credential: do not log it, and do not persist it outside the signup session.

200200 OK

400400 Missing city/state/country