post
https://{companyDomain}.bamboohr.com/api/v1/files/categories
Creates one or more company file categories. Accepts a JSON array of category name strings or an equivalent XML document. An empty payload returns 200 without creating anything. Returns 400 if a name is empty or already exists, 403 if the caller lacks permission or the name is reserved, and 500 on an internal error.
OAuth Scopes: company_file.write
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
The request was processed but no categories were created (empty payload).
All specified categories were created successfully.
The request body contains malformed JSON or XML, an empty category name, or a category name that already exists.
The API user does not have permission to create company file categories, or the category name is reserved.
An internal server error occurred.