Create a folder

POST/api/v1/mailbox/folders
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Creates and subscribes an IMAP folder. This is also what the webmail's label management calls -- a label IS a folder here, not a separate concept invented in the UI.

Request body

Request

POST/api/v1/mailbox/folders
curl -X POST 'https://app.mailyte.com/api/v1/mailbox/folders' \
  -H 'Authorization: Bearer MAILBOX_TOKEN'
The key names its own organization, so no X-Organization-ID header is needed.

Response

Successful Response

Returned inside the standard envelope.

Errors

StatusWhen
422Validation Error

Every status, with what causes it and what to do, is on the error reference.