Save manual business address (step 3 — manual path)

Overview

Step 3 (manual path) of self-service signup, used when the user does not connect a Google Business Profile. Saves a manually entered business name and address (by city_id) and provisions the company/store/plan the same way as the Google path.

Prerequisites

  • No authentication — this endpoint is public.

Base URL

EnvironmentURL
Productionhttps://production-api.shoutaboutus.com
Developmenthttps://development-api.shoutaboutus.com

Endpoint

POST /api/v1/signup/account/business/info

Authentication

  • No bearer token required.

  • Public — no bearer token (auth: noauth).

Rate limit

  • 10 requests/min per IP. Public route.

Request body

FieldTypeRequiredDescription
signup_account_idintegerRequiredThe signup activation id.
business_namestringRequired≤100 chars; no angle brackets.
address1stringRequired≤255 chars.
address2stringOptional≤255 chars.
city_idintegerRequiredMust be an existing city.
postal_codestringRequired3–12 chars.
website_uristringOptionalValid URL.
{
  "signup_account_id": 101,
  "business_name": "Acme Plumbing",
  "address1": "123 Main St",
  "address2": "Suite 4",
  "city_id": 133682,
  "postal_code": "92014",
  "website_uri": "https://acmeplumbing.com"
}

How it works

  • Synchronous. 200 returns the activation snapshot including data.business.
  • 422 on validation failure.
  • 500 on provisioning failure (transaction rolled back).

Response

200 OK · 200

{
  "data": {
    "message": null,
    "account": {
      "id": 101,
      "email": "[email protected]",
      "email_verified_at": "2026-07-09T08:15:00.000000Z",
      "first_name": "Jane",
      "last_name": "Doe",
      "mobile": "+11234567890",
      "plan_id": 3,
      "plan_group_name": "Starter",
      "referral_code": null,
      "referral_company_id": null,
      "referral_company_name": "",
      "step": "feature_options",
      "who_will_pay": "brand",
      "hear_about_us": "Referral",
      "hear_others": null,
      "hide_password": null,
      "show_skip_google_connect_button": 0
    },
    "user": {
      "id": 4021
    },
    "business": {
      "id": 55,
      "signup_activation_id": 101,
      "business_name": "Acme Plumbing",
      "account_name": "Acme Plumbing",
      "address1": "123 Main St",
      "address2": "Suite 4",
      "city_id": 133682,
      "postal_code": "92014",
      "store_id": 8801,
      "google_access_token": null,
      "google_access_token_id": null
    },
    "feature_options": null,
    "meta_data": null
  }
}

422 Validation error · 422

{
  "message": "The city id field is required.",
  "errors": {
    "city_id": [
      "The city id field is required."
    ],
    "postal_code": [
      "The postal code field is required."
    ]
  }
}

Errors

StatusMeaning
422Validation error
500Returned on provisioning failure (transaction rolled back)

Example request

curl --request POST \
  --url "https://production-api.shoutaboutus.com/api/v1/signup/account/business/info" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"signup_account_id": 101, "business_name": "Acme Plumbing", "address1": "123 Main St", "address2": "Suite 4", "city_id": 133682, "postal_code": "92014", "website_uri": "https://acmeplumbing.com"}'

Did this page help you?