# createCollection

> Mutation in domain **Collections**

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

Create a new `Collection`. Currently supported for `Library` type parent entities only. Requires `basic:write` scope to be accessible and `Collection` permission level `EDIT`.

## Returns

`CreateCollection`

## Arguments

- `input`: `CreateCollectionInput!` — `CreateCollection` input argument.

## Example

```graphql
mutation CreateCollection {
  createCollection(
    input: {
      parentId: "…"
      name: "…"
    }
  ) {
    __typename
    collection {
      name
      id
      assets {
        total
        page
        limit
        hasNextPage
        items { id }
      }
      currentUserPermissions {
        canAddAssets
        canRemoveAssets
      }
    }
  }
}
```

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