---
title: marketCreate - GraphQL Admin
description: |-
  Creates a [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings) to control currency behavior. Set [`MarketPriceInclusions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketPriceInclusions) to determine tax and duty display. Assign [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) objects and [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) configurations to control product availability and SEO strategy.

  Learn more about [Shopify Markets](https://shopify.dev/docs/apps/build/markets).
api_version: 2025-01
api_name: admin
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketcreate
  md: https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/marketcreate.md
---

# market​Create

mutation

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

Creates a [`Market`](https://shopify.dev/docs/api/admin-graphql/latest/objects/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`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketCurrencySettings) to control currency behavior. Set [`MarketPriceInclusions`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketPriceInclusions) to determine tax and duty display. Assign [`Catalog`](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Catalog) objects and [`MarketWebPresence`](https://shopify.dev/docs/api/admin-graphql/latest/objects/MarketWebPresence) configurations to control product availability and SEO strategy.

Learn more about [Shopify Markets](https://shopify.dev/docs/apps/build/markets).

## Arguments

* input

  [Market​Create​Input!](https://shopify.dev/docs/api/admin-graphql/2025-01/input-objects/MarketCreateInput)

  required

  The properties of the new market.

***

## Market​Create​Payload returns

* market

  [Market](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/Market)

  The market object.

* user​Errors

  [\[Market​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/MarketUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### marketCreate reference

## Mutation Reference

```graphql
mutation marketCreate($input: MarketCreateInput!) {
  marketCreate(input: $input) {
    market {
      # Market fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "input": {
    "name": "<your-name>",
    "handle": "<your-handle>",
    "enabled": true,
    "regions": [
      {
        "countryCode": "AF"
      }
    ]
  }
}
```

##### Schema

```graphql
input MarketCreateInput {
  name: String!
  handle: String
  enabled: Boolean
  regions: [MarketRegionCreateInput!]!
}

input MarketRegionCreateInput {
  countryCode: CountryCode!
}
```