email_create_folder
Creates a new folder or label in one mailbox and returns it with the id you will need for email_move_message and folder-scoped searches. Check email_list_folders first — the folder the user described may already exist under a different name, and creating a near-duplicate splits their mail across two places. account_id chooses the mailbox; folders are not shared between accounts, so organizing several mailboxes the same way means one call each.
Input fields
{
"type": "object",
"properties": {
"account_id": {
"type": "string",
"minLength": 1,
"description": "The connected mailbox to act on, from email_accounts_list. Never guess this value and never reuse one across mailboxes — it selects both the credential and the permission set the call runs under."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Display name for the new folder, e.g. Receipts."
},
"parent_folder_id": {
"description": "Nest under this folder, using an id from email_list_folders. Omit to create at the top level. Providers that do not support nesting report it through can_use_folders.",
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"account_id",
"name"
]
}Tool behavior
May change provider state. Check the explicit account, required access and provider capabilities before invoking.
Inspect isError and per-account errors. General write tools do not all enforce exact-plan approval. This reference does not certify any current AI client version.
YOUR INBOXES.
UNDER CONTROL.
Get started Start with a free account and one read-only search. Existing accounts keep their connection.