Get My Mail Folders [only works with User Credentials]
Name
get_my_mailfolders
Description
Get the list of mail folders for the current user. [API reference]
Related Tables
Parameters
Parameter | Label | Required | Options | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
OrderBy | Order By | NO |
|
Order the specified column by ascending or descending order [API reference] | ||||||||||
SearchCriteria | Search Criteria | NO |
|
Data filter (e.g. somecolumn -eq 'somevalue') [API reference] | ||||||||||
PageSize | Page Size | NO | The number of records to include in each page of results [API reference] | |||||||||||
SelectedColumns | Selected Columns | NO | Select the individual columns to be included in the response, to reduce the response size and increase performance [API reference] |
Output Columns
Label | Data Type (SSIS) | Data Type (SQL) | Length | Raw | Description |
---|---|---|---|---|---|
Id |
DT_WSTR
|
nvarchar(1200)
|
1200 | False |
|
DisplayName |
DT_WSTR
|
nvarchar(500)
|
500 | False |
|
ParentFolderId |
DT_WSTR
|
nvarchar(1200)
|
1200 | False |
|
ChildFolderCount |
DT_I4
|
int
|
False |
||
UnreadItemCount |
DT_I4
|
int
|
False |
||
TotalItemCount |
DT_I4
|
int
|
False |
||
SizeInBytes |
DT_I4
|
int
|
False |
||
IsHidden |
DT_BOOL
|
bit
|
False |
Input Columns
Label | Data Type (SSIS) | Data Type (SQL) | Length | Raw | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
There are no Static columns defined for this endpoint. This endpoint detects columns dynamically at runtime. |
Examples
SSIS
Use Outlook Mail (Office 365) Connector in API Source component to read data or in API Destination component to read/write data:
Read from MyMailFolders table using API Destination
This Endpoint belongs to MyMailFolders table, therefore you cannot work with it directly. Use this table and table-operation pair instead:

ODBC application
Use these SQL queries in your ODBC application data source:
Get my mail folders [only works with user credentials]
SELECT * FROM get_my_mailfolders
Get all mail folders associated with the current user
SELECT * FROM MyMailFolders
get_my_mailfolders
endpoint belongs to
MyMailFolders
table(s), and can therefore be used via those table(s).
SQL Server
Use these SQL queries in SQL Server after you create a data source in Data Gateway:
Get my mail folders [only works with user credentials]
DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT * FROM get_my_mailfolders';
EXEC (@MyQuery) AT [LS_TO_OUTLOOK_MAIL_OFFICE_365_IN_GATEWAY];
Get all mail folders associated with the current user
DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT * FROM MyMailFolders';
EXEC (@MyQuery) AT [LS_TO_OUTLOOK_MAIL_OFFICE_365_IN_GATEWAY];
get_my_mailfolders
endpoint belongs to
MyMailFolders
table(s), and can therefore be used via those table(s).