Mail

Create a folder

Creates a folder, at the top level or under parent (an existing folder's path). Returns the new folder's path, which is what the move and list endpoints take. Requires scope mail:write.

post/mailboxes/{address}/folders

Request

  • Base URL: https://faivelo.com/api/v1
  • URL: https://faivelo.com/api/v1/mailboxes/{address}/folders
  • Auth: HTTP bearer

Path parameters

addressstring required

Full mailbox address, e.g. user@yourdomain.com

Request body

namestring required

One segment: no slashes

parentstring

The path of the folder to nest it under; omit for a top-level folder

Example request

{
  "name": "2026",
  "parent": "Projects"
}

Response

Folder created

successboolean

Example response

{
  "success": true,
  "data": {
    "path": "Projects/2026"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.