Mailbox API – Folders

type

String

"all", "mails", "events", "tasks", "notes", "contacts"

The folder type

Default value: "all"

Note: “public_container”, “shared_namespace” and “shared_container” are not available for this property

accessMode

String

"all", "local", "public", "shared"

List only folders matching this access mode

Default value: "all"

syncTokenOnly

Boolean

When true, the endpoint should only return the syncToken without the folder list.

Default value: false

name

String

*

The new folder name

type

String

"mails", "events", "tasks", "notes", "contacts"

The folder type

Default value: "mails" when parentId is not present or when it is equal to the root folder. Otherwise, the default value will be equal to the type of the parent folder.

Note: “public_container”, “shared_namespace” and “shared_container” are not available for this property

Note: if the parentId is sent and is not the root folder Id, then type should not be sent. In this case, if the type is sent and does not match the parent folder type, the request will result in a 400 error.

parentId

String

The parent folder ID

Default value: the folder container ID (root folder)

To create folders in the root folder, you can either omit the parentId property or use the folderContainerId provided in Account Info.

folderId

String

The folder id

name

String

*

The new folder name

folderId

String

The folder id

folderId

String

The folder id

parentId

String

*

The new parent folder ID; the container ID (root folder) for top level folders.