---
title: "Create a new store."
method: POST
path: "/store/setup.json"
tags: ["Stores"]
---

# Create a new store.

`POST /store/setup.json`

Creates a new store owned by the authenticated account. Requires a paying subscription with at least 24 hours since first payment. Limited to 5 store creations per account per day. Returns the new store API credentials.

## Request body

- StoreSetupCreate
  - `store` object, required
    - `name` string, required — Store name (4-50 characters). Will be used to generate the store subdomain.
    - `country` string — ISO 3166-1 alpha-2 country code. Defaults to the authenticated store's country.
    - `theme` string — Theme code to apply. Uses default theme if omitted.

## Response `201`

Store created successfully.

- StoreSetupResponse
  - `store` object
    - `code` string — Store unique code (subdomain).
    - `name` string — Store name.
    - `url` string — Store storefront URL.
    - `admin_url` string — Store admin panel URL.
  - `credentials` object
    - `login` string — API login key for the new store.
    - `authtoken` string — API authentication token for the new store.

## Other responses

- `400` — Bad Request - invalid name or JSON body.
- `402` — Payment Required - a paying subscription is required.
- `403` — Forbidden - store creation is available 24 hours after first payment.
- `429` — Too Many Requests - store creation limit exceeded (5 per day).

---

[API](https://skmtc.net/jumpseller/apis/jumpseller-api.md) · [All operations](https://skmtc.net/jumpseller/apis/jumpseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jumpseller/jumpseller-api/versions/7512c6ae3524/schema)