# createCustomMetadataProperty

> Mutation in domain **Metadata**

- HTML: [createCustomMetadataProperty.html](createCustomMetadataProperty.html)
- Raw SDL: [createCustomMetadataProperty.sdl](createCustomMetadataProperty.sdl)
- Covered by: [llms.txt](../llms.txt)

Create a new `CustomMetadataProperty`. RequiresRequires `basic:write` scope to be accessible and `Brand` or `Project` permission level `EDIT`.

## Returns

`CreateCustomMetadataProperty`

## Arguments

- `input`: `CreateCustomMetadataPropertyInput!` — `CreateCustomMetadataProperty` input argument.

## Example

```graphql
mutation CreateCustomMetadataProperty {
  createCustomMetadataProperty(
    input: {
      parentId: "…"
      name: "…"
      type: {
        name: SELECT
      }
    }
  ) {
    __typename
    property {
      name
      id
      createdAt
      defaultValue
      forbiddenDependeePropertyIds
      helpText
      creator {
        __typename
        name
        id
      }
      dependency {
        __typename
        propertyId
        type
        ... on CustomMetadataPropertySelectValueTypeDependencyTypeEquals {
          propertyOptionId
        }
        ... on CustomMetadataPropertySelectValueTypeDependencyTypeOneOf {
          propertyOptionIds
        }
      }
      modifier {
        __typename
        name
        id
      }
      permissions {
        basic { permissionLevel }
        custom { permissionLevel }
      }
      type {
        __typename
        name
        ... on CustomMetadataPropertyTypeCatalog {
          allowedLinkedColumnIds
          allowMultiSelect
        }
      }
    }
  }
}
```

Raw: [`createCustomMetadataProperty.example.sdl`](createCustomMetadataProperty.example.sdl)