get https://api.getknit.dev/v1.0/email.folders.list
Pagination behavior
- Default pageSize is 10
- For fetching next set of records always use pageToken
- Filters applied in initial request are honored, so keep filters same for subsequent request
- Google doesn't support pagination in the API
Folder hierarchy (Outlook Mail only)
- By default, only top level folders are listed
- Top level folders have
parentId = root- To list children folders, include the parent folder ID in the request
- Folder hierarchy and parent-child relationship is only supported in Outlook Mail
Supported Apps
Here is the list of apps that supports this API
Google Mail (google-mail)
Flat folder structure only
Outlook Mail (outlook-mail)
Supports hierarchical folder structure