folders

folders.create

Create Folder

Effects: write

📁 Create a new inbox folder to organize threads.

When to use:

• User wants to create a folder to group related conversations
• User wants to organize threads by topic, project, or contact type

After creating a folder, use threads.update with folder_id to move threads into it.

Arguments

Argument	Type	Required	Description
icon	string	no	Emoji icon for the folder (max 10 chars, optional)
name	string	yes	Folder name (max 100 chars)

folders.delete

Delete Folder

Effects: write

🗑️ Delete an inbox folder. Threads inside become unfiled (not deleted).

When to use:

• User wants to remove a folder they no longer need
• User wants to clean up their inbox organization

Threads inside the folder are NOT deleted — they simply move back to the inbox.

Arguments

Argument	Type	Required	Description
folder_id	integer	yes	ID of the folder to delete