> ## Documentation Index > Fetch the complete documentation index at: https://developers.redo.com/llms.txt > Use this file to discover all available pages before exploring further. # upsertMarket > Create a market, or update one when `id` is given. Returns null if no market with that id is owned by the caller. Adding a country sets it up on the store's sales channel, so this can take several seconds. Removing a country tears down its Shopify market, catalog and price list. Throws a 400 error with an extension code of MARKET_COUNTRIES_REQUIRED, DUPLICATE_MARKET_COUNTRY, MARKET_COUNTRY_ADDED_AND_REMOVED, MARKET_COUNTRY_NOT_IN_MARKET, INVALID_MARKUP, or INVALID_MARKET_SETTINGS when the input is invalid (settings are checked against the market as it would be after the update), a 400 error with an extension code of UNEXPECTED_MARKET_RESOLUTION for a resolution no conflict needs, a 409 CONFLICT error (with an extension code of MARKET_COUNTRY_IN_USE) when a country already belongs to another market, and a 409 CONFLICT error (with an extension code of MARKET_COUNTRY_CONFLICT and a `conflicts` extension listing, per country, the conflicting Shopify market handle, its other countries, a `reason` sentence explaining the conflict, and `allowedResolutions` as `{ kind, effect }` pairs whose `effect` says what that choice does to the merchant's Shopify market) when a country being added is in one of the merchant's own Shopify markets without an allowed resolution. Nothing is written when a request fails. **Required scopes:** [`markets_write`](/docs/api-reference/v3/reference/scopes#scope-markets_write) ## Arguments The id of the market to update. Omit to create one. UpsertMarketInput!} required> The market's settings. [CountryCode!]}> Destination countries to add. Required when creating. A country can belong to only one market; adding one this market already has does nothing. Each new country is set up as a market, catalog and price list on the store's sales channel. If a country is already in one of the merchant's own Shopify markets, the request fails with MARKET\_COUNTRY\_CONFLICT until `resolutions` says what to do with it. LandedCostBreakdownDisplay}> How uncharged landed-cost lines appear in the checkout breakdown. Defaults to REMOVE. MarketBreakdownLabelsInput}> Replaces the custom checkout breakdown labels. Send an empty object to restore the defaults. The label for the duties and fees line. The label for the shipping line. The label for the taxes line. [LandedCostComponent!]}> Landed-cost components whose checkout charge the markup absorbs, in order. Must not overlap `includedInPrice`. Whether the market's pricing is live. Defaults to false. [LandedCostComponent!]}> Landed-cost components neither charged nor shown at checkout. Must not overlap `includedInPrice`. [LandedCostComponent!]}> Landed-cost components to bake into product prices. FEES is only allowed with ADAPTIVE\_COEFFICIENT, which requires either TAXES alone or all three. Decimal}> The markup on the base price, as a fraction from "0" to "1" with at most 6 decimal places (e.g. "0.1" for 10%). Defaults to 0. MarketMarkupStrategy}> How the markup combines with the landed cost. Defaults to ABSORBING. The market's name. Send null or an empty string to clear. MarketPricingMode}> How landed costs are turned into prices. Defaults to COEFFICIENT, or CALCULATED when `includedInPrice` is set. [CountryCode!]}> Destination countries to remove. Not allowed when creating, and each must currently be in the market. Removing a country tears down its Shopify market, catalog and price list, so shoppers there stop seeing this market's prices. The market must keep at least one country. [MarketCountryConflictResolutionInput!]}> Resolutions for countries in `addCountryCodes` that are already in one of the merchant's own Shopify markets, as reported in a MARKET\_COUNTRY\_CONFLICT error: each conflict's `reason` explains it, and each of its `allowedResolutions` gives a `kind` to send here with an `effect` describing the outcome. TAKE\_OVER adopts that Shopify market; ARCHIVE\_EXISTING sets it to draft; REMOVE\_REGION removes the country from it. Naming a country without such a conflict fails with UNEXPECTED\_MARKET\_RESOLUTION. CountryCode!} required> A country in `addCountryCodes`. MarketCountryConflictResolutionKind!} required> The resolution. Must be a `kind` from the conflict's `allowedResolutions`; its `effect` says what happens to the merchant's Shopify market. ## Returns Market}> A cross-border market: a set of destination countries that share one landed-cost pricing policy. LandedCostBreakdownDisplay!} required> How uncharged landed-cost lines appear in the checkout breakdown. MarketBreakdownLabels!} required> Custom labels for the checkout landed-cost breakdown. The label for the duties and fees line. The label for the shipping line. The label for the taxes line. [MarketCountry!]!} required> The destination countries this market sells into. CountryCode!} required> The destination country. DateTime!} required> When the country was added to the market. The ISO 4217 currency shoppers in this country are charged in. Null until the country has been set up on the sales channel. DateTime!} required> When the record was last updated. [LandedCostComponent!]!} required> Landed-cost components whose checkout charge is absorbed by the markup, drawn down in order. DateTime!} required> When the record was created. Whether the market's pricing is live. [LandedCostComponent!]!} required> Landed-cost components neither charged nor shown at checkout. The id of this market. [LandedCostComponent!]!} required> Landed-cost components baked into product prices. DateTime}> When prices were last pushed to the sales channel. Null until the first sync. Decimal!} required> The markup on the base price, as a fraction (e.g. "0.1" for 10%). MarketMarkupStrategy!} required> How the markup combines with the landed cost in the price. The merchant-set name. Null when unnamed; the countries then identify the market. MarketPricingMode!} required> How landed costs are turned into prices. The ISO 4217 currency of the store's base prices, which the market's prices are converted from. DateTime!} required> When the record was last updated. ## Example ```graphql theme={null} mutation { upsertMarket(id: "...", input: { ... }) { breakdownDisplay coveredByMarkup createdAt enabled excludedFromCheckout id includedInPrice lastSyncedAt # ... } } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.