---
title: "Create a new store"
method: POST
path: "/v2/user/customer/stores"
tags: ["Customer - Stores"]
---

# Create a new store

`POST /v2/user/customer/stores`

## Request body

- CreateStoreRequest — The request to create a store. The store identifier is optional, if null it will be automatically computed.
  - `id` string, guid — The store identifier
  - `name` string, required — The store name. Must be unique.
  - `url` string, required — The url of your store
  - `countryIsoCodeAlpha3` string, required — The country iso code alpha 3 based on the list of values /user/lov/StoreCountryWithInternational
  - `sectors` StoreSector[], required — The store's sectors based on the list of values /user/lov/ParamSector

## Response `201`

The store has been created successfully. The http header Location contains the new resource url. The body contains the link to the new resource.

- LinksGetStoreLink
  - `label` string — The label corresponding to the link. This label is automatically translated based on the Accept-Language http header.
  - `docUrl` string, uri — The documentation related to this operation.
  - `description` string — The description of the link
  - `href` string, required — Indicate the relative uri for this link
  - `operationId` string — The operationId to call.
  - `method` 'GET' | 'POST' | 'PATCH' | 'DELETE' | 'PUT' | 'HEAD' — Indicate the http method to use on this link
  - `parameters` object
  - `urlTemplated` boolean — indicates whether the href is templated or not
  - `allRequiredParamsProvided` boolean — indicates whether all required params have been provided
  - `allOptionalParamsProvided` boolean — indicates whether all optionals params have been provided
  - `info` BeezUPCommonInfoSummaries
    - `successes` BeezUPCommonSuccessSummary[]
      - `successCode` string
      - `successMessage` string
      - `successArguments` object
      - `propertyName` string
      - `propertyValue` string
      - `objectName` string
    - `errors` BeezUPCommonErrorSummary[]
      - `utcDate` string, date-time
      - `errorGuid` string, uuid
      - `errorCode` string
      - `errorMessage` string
      - `technicalErrorMessage` string
      - `exceptionDetail` BeezUPCommonExceptionDetail
        - `helpLink` string
        - `message` string
        - `stackTrace` string
        - `type` string
      - `errorArguments` object
      - `propertyName` string
      - `propertyValue` string
      - `objectName` string
      - `source` string
    - `warnings` BeezUPCommonWarningSummary[]
      - `technicalErrorMessage` string
      - `warningMessage` string
      - `warningCode` string
      - `warningArguments` object
    - `informations` BeezUPCommonInfoSummary[]
      - `informationCode` string
      - `informationMessage` string
      - `informationArguments` object
      - `propertyName` string
      - `propertyValue` string
      - `objectName` string

## Other responses

- `402` — The maximum amount of store has been reached. Please upgrade your contract.
- `409` — The customer has a store with the same name
- `default` — Occurs when something goes wrong

---

[API](https://skmtc.net/beezup/apis/beezup-merchant-api.md) · [All operations](https://skmtc.net/beezup/apis/beezup-merchant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/beezup/beezup-merchant-api/revisions/557b7feddf8a/schema)