---
title: metaobjectsCreate - GraphQL Admin
description: Creates up to 25 metaobjects of the same type.
api_version: unstable
api_name: admin
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/metaobjectsCreate
  md: >-
    https://shopify.dev/docs/api/admin-graphql/unstable/mutations/metaobjectsCreate.md
---

# metaobjects​Create

mutation

Requires `write_metaobjects` access scope.

Creates up to 25 metaobjects of the same type.

## Arguments

* input

  [Metaobjects​Create​Input!](https://shopify.dev/docs/api/admin-graphql/unstable/input-objects/MetaobjectsCreateInput)

  required

  The parameters for the metaobjects to create.

***

## Metaobjects​Create​Payload returns

* metaobjects

  [\[Metaobject!\]](https://shopify.dev/docs/api/admin-graphql/unstable/objects/Metaobject)

  The created metaobjects.

* user​Errors

  [\[Metaobject​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/unstable/objects/MetaobjectUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### metaobjectsCreate reference

## Mutation Reference

```graphql
mutation metaobjectsCreate($input: MetaobjectsCreateInput!) {
  metaobjectsCreate(input: $input) {
    metaobjects {
      # Metaobject fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

##### Variables

```json
{
  "input": {
    "type": "<your-type>",
    "metaobjects": [
      {
        "handle": "<your-handle>",
        "fields": [
          {}
        ],
        "capabilities": {}
      }
    ]
  }
}
```

##### Schema

```graphql
input MetaobjectsCreateInput {
  type: String!
  metaobjects: [MetaobjectsCreateMetaobjectInput!]!
}

input MetaobjectsCreateMetaobjectInput {
  handle: String
  fields: [MetaobjectFieldInput!]
  capabilities: MetaobjectCapabilityDataInput
}
```