---
title: "Create Content Library Item"
method: POST
path: "/public/v1/content-library-items"
tags: ["Content Library Items"]
---

# Create Content Library Item

`POST /public/v1/content-library-items`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/content-library-items`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/content-library-items/post.ts> (a function with typed inputs; its response is checked against the schema)

This API endpoint allows users to create an empty item in the content library.
No actual content or data is required to be provided in the initial creation.

## Request body

- ContentLibraryItemCreateFromUrlRequest
  - `url` string: Secure (HTTPS) and publicly accessible URL to the PDF document.
  - `editable` boolean: Only applicable when creating a content library item from a DOCX file. When `true`, the DOCX is converted into editable content, so the resulting content library item can be edited.
  - `name` string: The name of the Content Library Item.

## Response `201`

OK

- ContentLibraryResponse
  - `id` string
  - `name` string
  - `date_created` string, date-time
  - `date_modified` string, date-time
  - `version` string
  - `status` 'cli.UPLOADED' | 'cli.PROCESSED' | 'cli.ERROR'

## Other responses

- `400`: Bad Request
- `401`: Authentication error
- `403`: Permission error
- `429`: Too Many Requests

## Changes

- **2026-11-03** `b9a306b1a421`: 1 info
  - added the new optional request property `allOf[#/components/schemas/ContentLibraryItemCreateRequest]/editable`

[Operation history](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/changes/public/v1/content-library-items/post.md)

---

[API](https://skmtc.dev/pandadoc/apis/pandadoc-public-api.md) - [All operations](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pandadoc/apis/pandadoc-public-api/revisions/b9a306b1a421?raw)