Create a market

Creates a new market for the current store.

country_isos accepts 2-letter ISO country codes (e.g. ["DE", "FR"]); the market must contain at least one country. Unknown codes are silently dropped.
supported_locales accepts an array of locale codes; the default_locale is always implicitly included.
Setting default: true automatically demotes the previous default market in the store.

Required scope: write_settings (for API-key authentication).

POST

api

admin

markets

Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const market = await client.markets.create({
  name: 'Europe',
  currency: 'EUR',
  default_locale: 'de',
  supported_locales: ['de', 'en', 'fr'],
  tax_inclusive: true,
  country_isos: ['DE', 'FR', 'IT'],
})

spree api post /markets -d '{"name":"Europe","currency":"EUR","default_locale":"de","supported_locales":["de","en","fr"],"tax_inclusive":true,"country_isos":["DE","FR","IT"]}'

{
  "id": "mkt_gbHJdmfrXB",
  "name": "France only",
  "currency": "EUR",
  "default_locale": "fr",
  "tax_inclusive": true,
  "default": false,
  "country_isos": [
    "FR"
  ],
  "supported_locales": [
    "en",
    "fr"
  ],
  "created_at": "2026-07-24T18:11:08.409Z",
  "updated_at": "2026-07-24T18:11:08.409Z"
}

{
  "error": {
    "code": "validation_error",
    "message": "Name can't be blank, Currency can't be blank, Default locale can't be blank, and Countries can't be blank",
    "details": {
      "name": [
        "can't be blank"
      ],
      "currency": [
        "can't be blank"
      ],
      "default_locale": [
        "can't be blank"
      ],
      "countries": [
        "can't be blank"
      ]
    }
  }
}

Authorizations

x-spree-api-key

string

header

required

Secret API key for admin access

Authorization

string

header

required

JWT token for admin user authentication

Headers

x-spree-api-key

string

required

Authorization

string

required

Body

application/json

name

string

required

Example:

"Europe"

currency

string

required

ISO 4217 currency code.

Example:

"EUR"

default_locale

string

required

IETF locale tag used as the market default.

Example:

"de"

country_isos

string[]

required

2-letter ISO country codes assigned to this market. At least one is required.

Example:

["DE", "FR"]

supported_locales

string[]

Locale codes available in this market. The default is always implicitly included.

Example:

["de", "en"]

tax_inclusive

boolean

default:false

Display prices with tax included.

default

boolean

default:false

Setting to true demotes the previous default.

position

integer

Sort order within the store; lower = first.

Response

market created

string

required

name

string

required

currency

string

required

default_locale

string

required

tax_inclusive

boolean

required

default

boolean

required

country_isos

string[]

required

supported_locales

string[]

required

created_at

string

required

updated_at

string

required

countries

object[]

Show child attributes

List markets

Get a market

⌘I

Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const market = await client.markets.create({
  name: 'Europe',
  currency: 'EUR',
  default_locale: 'de',
  supported_locales: ['de', 'en', 'fr'],
  tax_inclusive: true,
  country_isos: ['DE', 'FR', 'IT'],
})

spree api post /markets -d '{"name":"Europe","currency":"EUR","default_locale":"de","supported_locales":["de","en","fr"],"tax_inclusive":true,"country_isos":["DE","FR","IT"]}'

{
  "id": "mkt_gbHJdmfrXB",
  "name": "France only",
  "currency": "EUR",
  "default_locale": "fr",
  "tax_inclusive": true,
  "default": false,
  "country_isos": [
    "FR"
  ],
  "supported_locales": [
    "en",
    "fr"
  ],
  "created_at": "2026-07-24T18:11:08.409Z",
  "updated_at": "2026-07-24T18:11:08.409Z"
}

{
  "error": {
    "code": "validation_error",
    "message": "Name can't be blank, Currency can't be blank, Default locale can't be blank, and Countries can't be blank",
    "details": {
      "name": [
        "can't be blank"
      ],
      "currency": [
        "can't be blank"
      ],
      "default_locale": [
        "can't be blank"
      ],
      "countries": [
        "can't be blank"
      ]
    }
  }
}

API basics

Endpoints

Create a market

Authorizations

Headers

Body

Response