Choose a version:

marketCreate

mutation

Requires read_markets for queries and both read_markets as well as write_markets for mutations.

Creates a Market to deliver customized shopping experiences. Markets define various aspects of the buyer experience including pricing, product availability, custom content, inventory and fulfillment priorities, and payment methods.

Define conditions to match buyers by region, company location, retail location, or other criteria. Configure MarketCurrencySettings to control currency behavior. Set MarketPriceInclusions to determine tax and duty display. Assign Catalog objects and MarketWebPresence configurations to control product availability and SEO strategy.

Learn more about Shopify Markets.

Anchor to Arguments

Arguments

Anchor to inputinput

•MarketCreateInput!

required

The properties of the new market.

Was this section helpful?

Anchor to MarketCreatePayload returnsMarketCreatePayload returns

Anchor to marketmarket •Market: The market object.
Anchor to userErrorsuserErrors •[MarketUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Create a B2B market for all company locations located in the United States

Description

Create a B2B market for all company locations located in the United States. The market includes all existing and future company locations located in the United States. This market type is currently only available in the dev preview.

Query

mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      id
      handle
      status
      conditions {
        companyLocationsCondition {
          companyLocations(first: 10) {
            edges {
              node {
                id
              }
            }
          }
        }
      }
      currencySettings {
        baseCurrency {
          currencyCode
        }
        localCurrencies
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "input": {
    "name": "Company Location Market",
    "handle": "Company-Location",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          }
        ]
      },
      "companyLocationsCondition": {
        "applicationLevel": "ALL"
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation marketCreate($input: MarketCreateInput!) { marketCreate(input: $input) { market { id handle status conditions { companyLocationsCondition { companyLocations(first: 10) { edges { node { id } } } } } currencySettings { baseCurrency { currencyCode } localCurrencies } } userErrors { field message code } } }",
 "variables": {
    "input": {
      "name": "Company Location Market",
      "handle": "Company-Location",
      "enabled": true,
      "conditions": {
        "regionsCondition": {
          "regions": [
            {
              "countryCode": "US"
            }
          ]
        },
        "companyLocationsCondition": {
          "applicationLevel": "ALL"
        }
      },
      "currencySettings": {
        "baseCurrency": "USD",
        "localCurrencies": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "input": {
            "name": "Company Location Market",
            "handle": "Company-Location",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "companyLocationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "input": {
    "name": "Company Location Market",
    "handle": "Company-Location",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          }
        ]
      },
      "companyLocationsCondition": {
        "applicationLevel": "ALL"
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation marketCreate($input: MarketCreateInput!) {
      marketCreate(input: $input) {
        market {
          id
          handle
          status
          conditions {
            companyLocationsCondition {
              companyLocations(first: 10) {
                edges {
                  node {
                    id
                  }
                }
              }
            }
          }
          currencySettings {
            baseCurrency {
              currencyCode
            }
            localCurrencies
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "input": {
            "name": "Company Location Market",
            "handle": "Company-Location",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "companyLocationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
});

Response

{
  "marketCreate": {
    "market": {
      "id": "gid://shopify/Market/1068177656",
      "handle": "company-location",
      "status": "ACTIVE",
      "conditions": {
        "companyLocationsCondition": {
          "companyLocations": {
            "edges": []
          }
        }
      },
      "currencySettings": {
        "baseCurrency": {
          "currencyCode": "USD"
        },
        "localCurrencies": false
      }
    },
    "userErrors": []
  }
}

Create a B2B market with a specific currency and price inclusions

Description

Create a B2B market for a specific company location with a specific currency and price inclusions. This market type is currently only available in the dev preview.

Query

mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      id
      handle
      status
      conditions {
        companyLocationsCondition {
          companyLocations(first: 10) {
            edges {
              node {
                id
              }
            }
          }
        }
      }
      currencySettings {
        baseCurrency {
          currencyCode
        }
        localCurrencies
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "input": {
    "name": "Company Location Market",
    "handle": "company-location-market",
    "enabled": true,
    "conditions": {
      "companyLocationsCondition": {
        "companyLocationIds": [
          "gid://shopify/CompanyLocation/423757199"
        ]
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation marketCreate($input: MarketCreateInput!) { marketCreate(input: $input) { market { id handle status conditions { companyLocationsCondition { companyLocations(first: 10) { edges { node { id } } } } } currencySettings { baseCurrency { currencyCode } localCurrencies } } userErrors { field message code } } }",
 "variables": {
    "input": {
      "name": "Company Location Market",
      "handle": "company-location-market",
      "enabled": true,
      "conditions": {
        "companyLocationsCondition": {
          "companyLocationIds": [
            "gid://shopify/CompanyLocation/423757199"
          ]
        }
      },
      "currencySettings": {
        "baseCurrency": "USD",
        "localCurrencies": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "input": {
            "name": "Company Location Market",
            "handle": "company-location-market",
            "enabled": true,
            "conditions": {
                "companyLocationsCondition": {
                    "companyLocationIds": [
                        "gid://shopify/CompanyLocation/423757199"
                    ]
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "input": {
    "name": "Company Location Market",
    "handle": "company-location-market",
    "enabled": true,
    "conditions": {
      "companyLocationsCondition": {
        "companyLocationIds": [
          "gid://shopify/CompanyLocation/423757199"
        ]
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation marketCreate($input: MarketCreateInput!) {
      marketCreate(input: $input) {
        market {
          id
          handle
          status
          conditions {
            companyLocationsCondition {
              companyLocations(first: 10) {
                edges {
                  node {
                    id
                  }
                }
              }
            }
          }
          currencySettings {
            baseCurrency {
              currencyCode
            }
            localCurrencies
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "input": {
            "name": "Company Location Market",
            "handle": "company-location-market",
            "enabled": true,
            "conditions": {
                "companyLocationsCondition": {
                    "companyLocationIds": [
                        "gid://shopify/CompanyLocation/423757199"
                    ]
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
});

Response

{
  "marketCreate": {
    "market": {
      "id": "gid://shopify/Market/1068177655",
      "handle": "company-location-market",
      "status": "ACTIVE",
      "conditions": {
        "companyLocationsCondition": {
          "companyLocations": {
            "edges": [
              {
                "node": {
                  "id": "gid://shopify/CompanyLocation/423757199"
                }
              }
            ]
          }
        }
      },
      "currencySettings": {
        "baseCurrency": {
          "currencyCode": "USD"
        },
        "localCurrencies": false
      }
    },
    "userErrors": []
  }
}

Create a North America market with a catalog and web presences

Description

Create a region market matching buyers located in the United States, Canada, and Mexico.

Query

mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      id
      handle
      status
      conditions {
        regionsCondition {
          regions(first: 10) {
            edges {
              node {
                id
                name
              }
            }
          }
        }
      }
      catalogs(first: 10) {
        edges {
          node {
            id
          }
        }
      }
      webPresences(first: 10) {
        edges {
          node {
            domain {
              id
            }
            subfolderSuffix
          }
        }
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "input": {
    "name": "North America Market",
    "handle": "NA",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          },
          {
            "countryCode": "CA"
          },
          {
            "countryCode": "MX"
          }
        ]
      }
    },
    "catalogs": [
      "gid://shopify/Catalog/307400570"
    ],
    "webPresences": [
      "gid://shopify/MarketWebPresence/1068177655"
    ]
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation marketCreate($input: MarketCreateInput!) { marketCreate(input: $input) { market { id handle status conditions { regionsCondition { regions(first: 10) { edges { node { id name } } } } } catalogs(first: 10) { edges { node { id } } } webPresences(first: 10) { edges { node { domain { id } subfolderSuffix } } } } userErrors { field message code } } }",
 "variables": {
    "input": {
      "name": "North America Market",
      "handle": "NA",
      "enabled": true,
      "conditions": {
        "regionsCondition": {
          "regions": [
            {
              "countryCode": "US"
            },
            {
              "countryCode": "CA"
            },
            {
              "countryCode": "MX"
            }
          ]
        }
      },
      "catalogs": [
        "gid://shopify/Catalog/307400570"
      ],
      "webPresences": [
        "gid://shopify/MarketWebPresence/1068177655"
      ]
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          regionsCondition {
            regions(first: 10) {
              edges {
                node {
                  id
                  name
                }
              }
            }
          }
        }
        catalogs(first: 10) {
          edges {
            node {
              id
            }
          }
        }
        webPresences(first: 10) {
          edges {
            node {
              domain {
                id
              }
              subfolderSuffix
            }
          }
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "input": {
            "name": "North America Market",
            "handle": "NA",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        },
                        {
                            "countryCode": "CA"
                        },
                        {
                            "countryCode": "MX"
                        }
                    ]
                }
            },
            "catalogs": [
                "gid://shopify/Catalog/307400570"
            ],
            "webPresences": [
                "gid://shopify/MarketWebPresence/1068177655"
            ]
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          regionsCondition {
            regions(first: 10) {
              edges {
                node {
                  id
                  name
                }
              }
            }
          }
        }
        catalogs(first: 10) {
          edges {
            node {
              id
            }
          }
        }
        webPresences(first: 10) {
          edges {
            node {
              domain {
                id
              }
              subfolderSuffix
            }
          }
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "input": {
    "name": "North America Market",
    "handle": "NA",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          },
          {
            "countryCode": "CA"
          },
          {
            "countryCode": "MX"
          }
        ]
      }
    },
    "catalogs": [
      "gid://shopify/Catalog/307400570"
    ],
    "webPresences": [
      "gid://shopify/MarketWebPresence/1068177655"
    ]
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation marketCreate($input: MarketCreateInput!) {
      marketCreate(input: $input) {
        market {
          id
          handle
          status
          conditions {
            regionsCondition {
              regions(first: 10) {
                edges {
                  node {
                    id
                    name
                  }
                }
              }
            }
          }
          catalogs(first: 10) {
            edges {
              node {
                id
              }
            }
          }
          webPresences(first: 10) {
            edges {
              node {
                domain {
                  id
                }
                subfolderSuffix
              }
            }
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "input": {
            "name": "North America Market",
            "handle": "NA",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        },
                        {
                            "countryCode": "CA"
                        },
                        {
                            "countryCode": "MX"
                        }
                    ]
                }
            },
            "catalogs": [
                "gid://shopify/Catalog/307400570"
            ],
            "webPresences": [
                "gid://shopify/MarketWebPresence/1068177655"
            ]
        }
    },
  },
});

Response

{
  "marketCreate": {
    "market": {
      "id": "gid://shopify/Market/1068177654",
      "handle": "na",
      "status": "ACTIVE",
      "conditions": {
        "regionsCondition": {
          "regions": {
            "edges": [
              {
                "node": {
                  "id": "gid://shopify/MarketRegionCountry/397370199",
                  "name": "United States"
                }
              },
              {
                "node": {
                  "id": "gid://shopify/MarketRegionCountry/948873163",
                  "name": "Canada"
                }
              },
              {
                "node": {
                  "id": "gid://shopify/MarketRegionCountry/1072830589",
                  "name": "Mexico"
                }
              }
            ]
          }
        }
      },
      "catalogs": {
        "edges": [
          {
            "node": {
              "id": "gid://shopify/MarketCatalog/307400570"
            }
          }
        ]
      },
      "webPresences": {
        "edges": [
          {
            "node": {
              "domain": {
                "id": "gid://shopify/Domain/1071590560"
              },
              "subfolderSuffix": null
            }
          }
        ]
      }
    },
    "userErrors": []
  }
}

Create a POS market for all locations

Description

Create a POS market for all locations. The market includes all existing and future locations. This market type is currently only available in the dev preview.

Query

mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      id
      handle
      status
      conditions {
        locationsCondition {
          locations(first: 10) {
            edges {
              node {
                id
              }
            }
          }
        }
      }
      currencySettings {
        baseCurrency {
          currencyCode
        }
        localCurrencies
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

Variables

{
  "input": {
    "name": "All POS Market",
    "handle": "all-pos-market",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          }
        ]
      },
      "locationsCondition": {
        "applicationLevel": "ALL"
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation marketCreate($input: MarketCreateInput!) { marketCreate(input: $input) { market { id handle status conditions { locationsCondition { locations(first: 10) { edges { node { id } } } } } currencySettings { baseCurrency { currencyCode } localCurrencies } } userErrors { field message code } } }",
 "variables": {
    "input": {
      "name": "All POS Market",
      "handle": "all-pos-market",
      "enabled": true,
      "conditions": {
        "regionsCondition": {
          "regions": [
            {
              "countryCode": "US"
            }
          ]
        },
        "locationsCondition": {
          "applicationLevel": "ALL"
        }
      },
      "currencySettings": {
        "baseCurrency": "USD",
        "localCurrencies": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          locationsCondition {
            locations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "input": {
            "name": "All POS Market",
            "handle": "all-pos-market",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "locationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          locationsCondition {
            locations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "input": {
    "name": "All POS Market",
    "handle": "all-pos-market",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          }
        ]
      },
      "locationsCondition": {
        "applicationLevel": "ALL"
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation marketCreate($input: MarketCreateInput!) {
      marketCreate(input: $input) {
        market {
          id
          handle
          status
          conditions {
            locationsCondition {
              locations(first: 10) {
                edges {
                  node {
                    id
                  }
                }
              }
            }
          }
          currencySettings {
            baseCurrency {
              currencyCode
            }
            localCurrencies
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "input": {
            "name": "All POS Market",
            "handle": "all-pos-market",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "locationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
});

Response

{
  "marketCreate": {
    "market": {
      "id": "gid://shopify/Market/1068177657",
      "handle": "all-pos-market",
      "status": "ACTIVE",
      "conditions": {
        "locationsCondition": {
          "locations": {
            "edges": []
          }
        }
      },
      "currencySettings": {
        "baseCurrency": {
          "currencyCode": "USD"
        },
        "localCurrencies": false
      }
    },
    "userErrors": []
  }
}

marketCreate reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation marketCreate($input: MarketCreateInput!) {

marketCreate(input: $input) {

market {

handle

status

conditions {

companyLocationsCondition {

companyLocations(first: 10) {

edges {

node {

}

currencySettings {

baseCurrency {

currencyCode

}

localCurrencies

}

userErrors {

field

message

code

}

}`,

{

variables: {

"input": {

"name": "Company Location Market",

"handle": "Company-Location",

"enabled": true,

"conditions": {

"regionsCondition": {

"regions": [

{

"countryCode": "US"

}

]

"companyLocationsCondition": {

"applicationLevel": "ALL"

}

"currencySettings": {

"baseCurrency": "USD",

"localCurrencies": false

}

);

const json = await response.json();

return json.data;

}

GQL

mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      id
      handle
      status
      conditions {
        companyLocationsCondition {
          companyLocations(first: 10) {
            edges {
              node {
                id
              }
            }
          }
        }
      }
      currencySettings {
        baseCurrency {
          currencyCode
        }
        localCurrencies
      }
    }
    userErrors {
      field
      message
      code
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation marketCreate($input: MarketCreateInput!) { marketCreate(input: $input) { market { id handle status conditions { companyLocationsCondition { companyLocations(first: 10) { edges { node { id } } } } } currencySettings { baseCurrency { currencyCode } localCurrencies } } userErrors { field message code } } }",
 "variables": {
    "input": {
      "name": "Company Location Market",
      "handle": "Company-Location",
      "enabled": true,
      "conditions": {
        "regionsCondition": {
          "regions": [
            {
              "countryCode": "US"
            }
          ]
        },
        "companyLocationsCondition": {
          "applicationLevel": "ALL"
        }
      },
      "currencySettings": {
        "baseCurrency": "USD",
        "localCurrencies": false
      }
    }
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }`,
  {
    variables: {
        "input": {
            "name": "Company Location Market",
            "handle": "Company-Location",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "companyLocationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation marketCreate($input: MarketCreateInput!) {
      marketCreate(input: $input) {
        market {
          id
          handle
          status
          conditions {
            companyLocationsCondition {
              companyLocations(first: 10) {
                edges {
                  node {
                    id
                  }
                }
              }
            }
          }
          currencySettings {
            baseCurrency {
              currencyCode
            }
            localCurrencies
          }
        }
        userErrors {
          field
          message
          code
        }
      }
    }`,
    "variables": {
        "input": {
            "name": "Company Location Market",
            "handle": "Company-Location",
            "enabled": true,
            "conditions": {
                "regionsCondition": {
                    "regions": [
                        {
                            "countryCode": "US"
                        }
                    ]
                },
                "companyLocationsCondition": {
                    "applicationLevel": "ALL"
                }
            },
            "currencySettings": {
                "baseCurrency": "USD",
                "localCurrencies": false
            }
        }
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation marketCreate($input: MarketCreateInput!) {
    marketCreate(input: $input) {
      market {
        id
        handle
        status
        conditions {
          companyLocationsCondition {
            companyLocations(first: 10) {
              edges {
                node {
                  id
                }
              }
            }
          }
        }
        currencySettings {
          baseCurrency {
            currencyCode
          }
          localCurrencies
        }
      }
      userErrors {
        field
        message
        code
      }
    }
  }
QUERY

variables = {
  "input": {
    "name": "Company Location Market",
    "handle": "Company-Location",
    "enabled": true,
    "conditions": {
      "regionsCondition": {
        "regions": [
          {
            "countryCode": "US"
          }
        ]
      },
      "companyLocationsCondition": {
        "applicationLevel": "ALL"
      }
    },
    "currencySettings": {
      "baseCurrency": "USD",
      "localCurrencies": false
    }
  }
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"input": {

"name": "Company Location Market",

"handle": "Company-Location",

"enabled": true,

"conditions": {

"regionsCondition": {

"regions": [

{

"countryCode": "US"

}

]

"companyLocationsCondition": {

"applicationLevel": "ALL"

}

"currencySettings": {

"baseCurrency": "USD",

"localCurrencies": false

}

Response

JSON

{

"marketCreate": {

"market": {

"id": "gid://shopify/Market/1068177656",

"handle": "company-location",

"status": "ACTIVE",

"conditions": {

"companyLocationsCondition": {

"companyLocations": {

"edges": []

}

"currencySettings": {

"baseCurrency": {

"currencyCode": "USD"

"localCurrencies": false

}

"userErrors": []

}