---
title: "Create a New Book"
method: POST
path: "/api/v2/content/books"
tags: ["Content - Books"]
---

# Create a New Book

`POST /api/v2/content/books`

This endpoint creates a new book in the system. <br><br>For Global Admin Tool Organizations, if the `X-Degreed-Organization-Code` header is included, the endpoint will create content for the Tenant Organization related to the header value as long as the organization is a member of the Global Admin Tool Organization. <h3>Required Scope</h3>`content:write`

## Headers

- `X-Degreed-Organization-Code` string

## Request body

- ContentBooksBody
  - `data` Apiv2contentbooksData
    - `type` string
    - `attributes` Apiv2contentbooksDataAttributes
      - `title` string, required — The title of the book.
      - `subtitle` string, nullable — The subtitle of the book.
      - `authors` string, nullable — Comma delimited list of authors.
      - `pages` integer, nullable — Number of pages.
      - `summary` string, nullable — Short summary of the book.
      - `image-url` string, nullable — Cover image of the book.
      - `obsolete` boolean — If the book should be marked as obsolete.
      - `publish-date` string, date-time, nullable — Date that the book was published.
      - `language` string, nullable — Language of the book.
      - `external-id` string, required — External ID of the book. This is usually the URL where the book can be found.
      - `i-s-b-n-13` string, nullable — ISBN13 number of the book.
      - `format` string, nullable — The format of the book. This value appears in the UI as a filter option in search. Previously, only a list of acceptable values were allowed, however, now any value is allowed.
      - `owner-id` string — The unique ID of the group or user that owns the content.
      - `owner-type` string — Must be either "user" or "group".

## Response `201`

Success

- PostedBook
  - `data` PostedBookData
    - `type` string
    - `id` string
    - `attributes` PostedBookDataAttributes
      - `title` string — The title of the book.
      - `subtitle` string, nullable — The subtitle of the book.
      - `authors` string, nullable — Comma delimited list of authors.
      - `pages` integer, nullable — Number of pages.
      - `learning-minutes` integer — The calculated value that corresponds with the learning minutes displayed on content cards in the UI. For example, 1 page in a book is equal to 1 learning minute.
      - `summary` string, nullable — Short summary of the book.
      - `image-url` string, nullable — Cover image of the book.
      - `obsolete` boolean — If the book should be marked as obsolete.
      - `publish-date` string, date-time, nullable — Date that the book was published. (UTC)
      - `language` string, nullable — Language of the book.
      - `degreed-url` string, nullable — URL location of the book within Degreed UI.
      - `owner-id` string — The unique ID of the group or user that owns the content.
      - `owner-type` string — Must be either "user" or "group".
      - `i-s-b-n-13` string, nullable — ISBN13 number of the book.
      - `created-at` string, date-time — Date that the book was created. (UTC)
      - `modified-at` string, date-time — Date that the book was last modified. (UTC)
      - `provider-code` string, nullable — Unique provider code.
      - `url` string, nullable — URL location where more information can be found.
      - `external-id` string — External ID of the book. This is usually the URL where the book can be found.
    - `links` SelfLink
      - `self` string

---

[API](https://skmtc.net/degreed/apis/degreed-api-web.md) · [All operations](https://skmtc.net/degreed/apis/degreed-api-web/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/degreed/degreed-api-web/revisions/4a22b709515c/schema)