Company Files
Public API
Create Company File Category
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
post/api/v1/files/categories
Request
- Base URLhttps://companySubDomain.bamboohr.com
- Auth
- HTTP basic
- or OAuth 2Authorization code/authorize.phpToken URL/token.phpScopescompany_file.write
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Request body
string[] required
Example request
[ "A new category" ]
Response
The request was processed but no categories were created (empty payload).
Changes
No recorded changes to this operation across all 2 revisions of this API.