--- title: shops.create | Doing Work API description: 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. url: https://doingwork.work/docs/reference/shops-create/ --- # 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](https://doingwork.work/docs/reference/#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 ```http 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](https://doingwork.work/docs/errors/). |