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
| App | App ID | Remarks |
|---|---|---|
| Google Mail | google-mail | Flat folder structure only |
| Outlook Mail | outlook-mail | Supports hierarchical folder structure |