Create a list folder

Creates a folder of the given kind (contactList by default). List-folder names are unique per kind (409 FOLDER_NAME_TAKEN); campaign and agent folders are created in their own services and answer their codes. Put lists into the folder with PATCH /business/lists/{listId} (folderId).

Errors:

• 409 FOLDER_NAME_TAKEN — A folder of that kind already carries the name.
• 400 INVALID_REQUEST — campaign/agent kinds only: the owning service rejected the request.
• 422 VALIDATION_FAILED — name missing/blank/over 120 characters, type outside the enum, or an unknown body key.
• 429 RATE_LIMITED — The lists rate bucket (120 requests/minute, 10,000/day per token owner) is exhausted, or the owning service (campaign/agent folders) refused the call.

Requires one of the following token scopes: lists.