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.
| Who | Agents can call this |
| REST | POST /v1/shops |
| MCP tool | shops_create |
| Writes | yes, send an Idempotency-Key |
| Area | Shop |
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
| Field | Type | Required |
|---|---|---|
name | string | yes |
jurisdiction | string | yes |
accept_terms_version | string | no |
owner_name | string | no |
partner_code | string | no |
referral_code | string | no |
lead_code | string | no |
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
| Code | Status | What to do |
|---|---|---|
invalid_input | 400 | A field is missing, the wrong type, or unknown. The message names the field. Fix the input; don't retry as is. |
feature_unavailable | 403 | This isn't available for this shop or place yet. |
invalid_input, invalid_token, rate_limited | Can happen on any call. See errors. |