Create a document

Create a document from a previously-uploaded file (via POST /v1/documents/upload-url using `upload_id`) or an external URL.

Authorization

bearerAuth documents.write

AuthorizationBearer <token>

Dashboard-issued token (pm_live_...) or OAuth-issued access token.

In: header

Scope: documents.write

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

Length1 <= length

upload_id?string

Opaque upload handle returned from POST /v1/documents/upload-url. Content type comes from the upload session, not this request.

Length1 <= length

source_url?string

Publicly-accessible HTTPS URL. Content type is inferred from the response Content-Type header; the URL must return a supported document MIME type.

Formaturi

folder_id?string

ID of an existing folder (in the team library) to place this document into. Folders must be created beforehand via POST /v1/folders — paths are derived server-side and not accepted from clients. Omit to upload to the library root.

create_link?boolean

If true, also create a default share link for this document.

Defaultfalse

Response Body

`application/json`

curl -X POST "https://api.papermark.com/v1/documents" \  -H "Content-Type: application/json" \  -d '{    "name": "pitch-deck-q4.pdf"  }'

{
  "id": "clxy9abc1234567890",
  "name": "pitch-deck-q4.pdf",
  "type": "pdf",
  "content_type": "application/pdf",
  "num_pages": 12,
  "folder_id": null,
  "created_at": "2026-04-17T10:00:00.000Z",
  "updated_at": "2026-04-17T10:00:00.000Z"
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing bearer token.",
    "doc_url": "https://www.papermark.com/docs/api/errors#unauthorized",
    "details": null
  }
}

Create a document

Authorization

Request Body

Response Body

201application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`