---
title: "Create a Personal Folder"
method: POST
path: "/references/personalfolder"
tags: ["References"]
---

# Create a Personal Folder

`POST /references/personalfolder`

Creates one or more personal (user-owned) reference folders. Each folder is owned by the specified UserId (access level 30 — Full). The owner is recorded automatically; it cannot be set via POST /references/folder/users.

Supports bulk creation: send an array with one or more items. A failure on one item does not affect others.

All responses use HTTP 200. Check each item's `success` field to determine the outcome. When `success` is false, the `error` field contains a description and `folderId` is null.

## Request body

- CreateUserFolderRequest[]
  - `folderName` string, nullable — The name of the folder to create. Cannot contain double quotes, backslashes, angle brackets, or control characters.
  - `userId` integer — The user who will become the folder owner. Must be greater than zero.

## Response `200`

Folders created.

- FolderCreatedResult[]
  - `folderName` string, nullable — Echo of the folder name from the request. Used to correlate results in bulk operations.
  - `folderId` string, nullable — The generated folder identifier (numeric or 32-character hex GUID). Null when Success is false.
  - `success` boolean — Indicates whether the folder was created successfully.
  - `error` string, nullable — Error description when Success is false. Null when the operation succeeds.

---

[API](https://skmtc.net/researchsolutions/apis/article-galaxy-api.md) · [All operations](https://skmtc.net/researchsolutions/apis/article-galaxy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/researchsolutions/article-galaxy-api/revisions/70fb92d278f5/schema)