---
title: "Create Account Folders"
method: POST
path: "/references/accountfolder"
tags: ["References"]
---

# Create Account Folders

`POST /references/accountfolder`

Creates one or more account-level reference folders. All users in the account receive the specified access level automatically — no individual assignments are required.

**Allowed accessLevel values:** 10 (Read), 20 (Write).

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

- CreateAccountFolderRequest[]
  - `folderName` string, nullable — The name of the folder to create. Cannot contain double quotes, backslashes, angle brackets, or control characters.
  - `accessLevel` integer — Access level granted to all users in the account. Accepted values: 10 (Read), 20 (Write).

## 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)
