shops.create

Create a shop. The caller becomes its one owner. The caller must already have accepted the current Terms and Privacy, once for their account, which covers every shop. Until then this call is refused and names /p/legal. On the sign-up page, one checkbox records both current versions (accept_terms_version) with the version, time, IP address and browser. A person who already accepted is not asked again. An agent cannot agree for them. owner_name, when it is a real name, replaces a display name that is only the email local part.

WhoAgents can call this
RESTPOST /v1/shops
MCP toolshops_create
Writesyes, send an Idempotency-Key
AreaShop

When to use it

The person doesn't have a shop yet. Ask the business name and state or province first.

What to tell the owner

I set up your shop. You're the owner.

Input

FieldTypeRequired
namestringyes
jurisdictionstringyes
accept_terms_versionstringno
owner_namestringno
partner_codestringno
referral_codestringno
lead_codestringno

Example

POST https://doingwork.work/v1/shops
content-type: application/json
Idempotency-Key: 3f1c...

{
  "name": "Ruiz Plumbing",
  "jurisdiction": "US-ID"
}

Output

JSON. The response shape isn't published yet; read the fields you need and ignore the rest. Errors are {code, message, status}.

Errors

CodeStatusWhat to do
invalid_input400A field is missing, the wrong type, or unknown. The message names the field. Fix the input; don't retry as is.
feature_unavailable403This isn't available for this shop or place yet.
invalid_input, invalid_token, rate_limitedCan happen on any call. See errors.