---
title: catalogCreate - GraphQL Admin
description: >-
  Creates a new catalog. For a complete explanation of a
  [`Catalog`](https://shopify.dev/api/admin-graphql/latest/interfaces/catalog)'s
  behaviour, and how you can use it with
  [`Publication`s](https://shopify.dev/api/admin-graphql/latest/objects/Publication)
  and
  [`PriceList`s](https://shopify.dev/api/admin-graphql/latest/objects/PriceList),
  see
  [here](https://shopify.dev/docs/apps/build/markets/catalogs-different-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/catalogCreate'
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2025-01/mutations/catalogCreate.md
---

# catalog​Create

mutation

Requires `write_products` access scope. Also: The user must have permission to create and edit catalogs.

Creates a new catalog. For a complete explanation of a [`Catalog`](https://shopify.dev/api/admin-graphql/latest/interfaces/catalog)'s behaviour, and how you can use it with [`Publication`s](https://shopify.dev/api/admin-graphql/latest/objects/Publication) and [`PriceList`s](https://shopify.dev/api/admin-graphql/latest/objects/PriceList), see [here](https://shopify.dev/docs/apps/build/markets/catalogs-different-markets).

## Arguments

* input

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

  required

  The properties of the new catalog.

***

## Catalog​Create​Payload returns

* catalog

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

  The newly created catalog.

* user​Errors

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

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### catalogCreate reference

## Mutation Reference

```graphql
mutation catalogCreate($input: CatalogCreateInput!) {
  catalogCreate(input: $input) {
    catalog {
      # Catalog fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "input": {
    "title": "<your-title>",
    "status": "ACTIVE",
    "context": {
      "companyLocationIds": [
        "gid://shopify/<objectName>/10079785100"
      ]
    },
    "priceListId": "gid://shopify/<objectName>/10079785100",
    "publicationId": "gid://shopify/<objectName>/10079785100"
  }
}
```

##### Schema

```graphql
input CatalogCreateInput {
  title: String!
  status: CatalogStatus!
  context: CatalogContextInput!
  priceListId: ID
  publicationId: ID
}

input CatalogContextInput {
  companyLocationIds: [ID!]
}
```