---
title: "Creates a new Library. Upon library creation, adds new library to all Admin accounts."
method: POST
path: "/api/Library/create"
tags: ["Library"]
---

# Creates a new Library. Upon library creation, adds new library to all Admin accounts.

`POST /api/Library/create`

## Request

- Base URL: `http://localhost:5000`
- URL: `http://localhost:5000/api/Library/create`
- Auth: API key in header `x-api-key`

## Request body

- UpdateLibraryDto
  - `id` integer, required
  - `name` string, required
  - `type` 0 | 1 | 2 | 3 | 4 | 5, required: Members: - `0` — Manga - `1` — Comic (Flexible) (Comic) - `2` — Book - `3` — Image - `4` — Light Novel (LightNovel) - `5` — Comic (ComicVine)
  - `folders` string[], required
  - `folderWatchMode` 0 | 1 | 2 | 3: Members: - `0` — Off - `1` — Automatic - `2` — File Watcher (FileWatcher) - `3` — Polling
  - `includeInDashboard` boolean, required
  - `includeInSearch` boolean, required
  - `manageCollections` boolean, required
  - `manageReadingLists` boolean, required
  - `allowScrobbling` boolean, required
  - `allowMetadataMatching` boolean, required
  - `enableMetadata` boolean, required
  - `removePrefixForSortName` boolean, required
  - `inheritWebLinksFromFirstChapter` boolean, required
  - `defaultLanguage` string, nullable
  - `metadataProvider` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup
  - `fileGroupTypes` FileTypeGroup[], required
  - `excludePatterns` string[], required

## Response `200`

OK

- LibraryDto
  - `id` integer
  - `name` string, nullable
  - `type` 0 | 1 | 2 | 3 | 4 | 5: Members: - `0` — Manga - `1` — Comic (Flexible) (Comic) - `2` — Book - `3` — Image - `4` — Light Novel (LightNovel) - `5` — Comic (ComicVine)
  - `lastScanned` string, date-time
  - `coverImage` string, nullable
  - `folderWatchMode` 0 | 1 | 2 | 3: Members: - `0` — Off - `1` — Automatic - `2` — File Watcher (FileWatcher) - `3` — Polling
  - `includeInDashboard` boolean
  - `includeInRecommended` boolean
  - `manageCollections` boolean
  - `manageReadingLists` boolean
  - `includeInSearch` boolean
  - `allowScrobbling` boolean
  - `folders` string[], nullable
  - `collapseSeriesRelationships` boolean
  - `libraryFileTypes` FileTypeGroup[], nullable
  - `excludePatterns` string[], nullable
  - `allowMetadataMatching` boolean
  - `enableMetadata` boolean
  - `removePrefixForSortName` boolean
  - `inheritWebLinksFromFirstChapter` boolean
  - `defaultLanguage` string, nullable
  - `metadataProvider` 2 | 3 | 4: Members: - `2` — Hardcover - `3` — Mangabaka - `4` — ComicBookRoundup

## Changes

- **2026-10-22** `7de671750636`: 6 warning, 6 info
  - removed the request property `folderWatching` (media type: application/json)
  - removed the request property `folderWatching` (media type: text/json)
  - removed the request property `folderWatching` (media type: application/*+json)
  - removed the optional property `folderWatching` from the response with the `200` status (media type: text/plain)
  - …8 more
- **2026-08-13** `3bd8363f0a4e`: 3 info
  - added the optional property `metadataProvider` to the response with the `200` status (media type: text/plain)
  - added the optional property `metadataProvider` to the response with the `200` status (media type: application/json)
  - added the optional property `metadataProvider` to the response with the `200` status (media type: text/json)
- **2026-07-02** `72a1166b481f`: 3 info
  - added the new optional request property `metadataProvider` (media type: application/json)
  - added the new optional request property `metadataProvider` (media type: text/json)
  - added the new optional request property `metadataProvider` (media type: application/*+json)
- **2026-02-28** `8a1111dbe609`: 3 info
  - added the media type `application/json` for the response with the status `200`
  - added the media type `text/json` for the response with the status `200`
  - added the media type `text/plain` for the response with the status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/kareadita/apis/kavita/changes/api/Library/create/post.md)

---

[API](https://skmtc.dev/kareadita/apis/kavita.md) - [All operations](https://skmtc.dev/kareadita/apis/kavita/llms.txt) - [OpenAPI document](https://skmtc.dev/kareadita/apis/kavita/revisions/d266465eeb67?raw)