---
title: MetafieldDefinitionCreatePayload - GraphQL Admin
description: Return type for `metafieldDefinitionCreate` mutation.
api_version: 2025-10
api_name: admin
type: payload
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/payloads/metafielddefinitioncreatepayload
  md: https://shopify.dev/docs/api/admin-graphql/latest/payloads/metafielddefinitioncreatepayload.md
---

# Metafield​Definition​Create​Payload

payload

Return type for `metafieldDefinitionCreate` mutation.

## Fields

* created​Definition

  [Metafield​Definition](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinition)

  The metafield definition that was created.

* user​Errors

  [\[Metafield​Definition​Create​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MetafieldDefinitionCreateUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [metafield​Definition​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/metafieldDefinitionCreate)

  mutation

  Creates a metafield definition. Any metafields existing under the same owner type, namespace, and key will be checked against this definition and will have their type updated accordingly. For metafields that are not valid, they will remain unchanged but any attempts to update them must align with this definition.

***

## Map

### Mutations with this payload

* [metafield​Definition​Create](https://shopify.dev/docs/api/admin-graphql/latest/types/metafieldDefinitionCreate)