# createFolder

> Mutation in domain **Folders**

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

Create a new `Folder`. Requires `basic:write` scope to be accessible and `Project` or `Folder` permission level `EDIT`.

## Returns

`CreateFolder`

## Arguments

- `input`: `CreateFolderInput!` — `CreateFolder` input argument.

## Example

```graphql
mutation CreateFolder {
  createFolder(
    input: {
      parentId: "…"
      name: "…"
    }
  ) {
    __typename
    folder {
      __typename
      name
      id
      createdAt
      modifiedAt
      assets {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      breadcrumbs {
        name
        id
      }
      creator {
        __typename
        name
        id
      }
      folders {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      modifier {
        __typename
        name
        id
      }
    }
  }
}
```

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