An FQL table containing information about a user's mailbox folders. The Graph API User object has an inbox connection that refers to the user's inbox folder.

To read mailbox_folder you need

• read_mailbox permissions

Example

Retrieve the number of unread inbox messages for the current user:

SELECT name, unread_count, total_count FROM mailbox_folder WHERE folder_id = 0 and viewer_id = me()

---

Columns

Indexable	Name	Type	Description
*	folder_id	string	The ID of the folder being queried. The ID can be one of: 0 (for Inbox), 1 (for Outbox), or 4 (for Updates).
*	viewer_id	int	The ID of the user whose Inbox you are querying.
	name	string	A short description of the folder being queried.
	unread_count	int	The number of unread threads in the folder being queried.
	total_count	int	The number of total threads.

---

See Also

• thread (FQL)

• message (FQL)