Create an Account List Folder

Request
Security:
bearerAuth
Request Body schema: application/json
folderName
string

The name of the Folder.

folderAccess
string (v2FolderAccess)
Default: "FOLDER_ACCESS_UNSPECIFIED"

The access level of the Folder.

  • FOLDER_ACCESS_UNSPECIFIED: No FolderAccess was provided.
  • PUBLIC: Anyone in the Organization associated with this Folder can view the contents of this Folder.
  • READ_ONLY: The Folder is Read Only.
Enum: "FOLDER_ACCESS_UNSPECIFIED" "PUBLIC" "READ_ONLY"
Responses
200

A successful response.

400

Returned when bad request is received.

401

Returned when a request is made without a valid API key

403

Returned when the given user does not have permissions on the requested resource

404

Returned when the given resource is not found

429

Returned when the given user has reached their API rate limits.

500

Returned when there is an unrecoverable error in the API. If you continue to receive this error, please contact support and include your terminus-request-id.

503

Returned when the service is currently unavailable.

post/accountLists/v2/folders
Request samples
    1 more
    Java
application/json
{
  • "folderName": "string",
  • "folderAccess": "FOLDER_ACCESS_UNSPECIFIED"
}
Response samples
    3 more
    429
    500
    503
application/json
{
  • "folderId": "string",
  • "displayName": "string",
  • "folderAccess": "FOLDER_ACCESS_UNSPECIFIED"
}