Reference

Endpoint 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

MyMailFolders

Parameters

Parameter Required Options
Name: OrderBy

Label: Order By

Order the specified column by ascending or descending order
Option Value
None
AscendingOrder SomeColumn asc
DescendingOrder SomeColumn desc
Name: SearchCriteria

Label: Search Criteria

Data filter (e.g. somecolumn -eq 'somevalue')
Option Value
None
Equal Search SomeColumn eq 'SomeValue'
Substring Search substringof(SomeField,'abc')
Starts With startswith(SomeField, 'abc')
Name: PageSize

Label: Page Size

The number of records to include in each page of results
Name: SelectedColumns

Label: Selected Columns

Select the individual columns to be included in the response, to reduce the response size and increase performance

Output Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
Id DT_WSTR nvarchar(1200) 1200
DisplayName DT_WSTR nvarchar(500) 500
ParentFolderId DT_WSTR nvarchar(1200) 1200
ChildFolderCount DT_I4 int
UnreadItemCount DT_I4 int
TotalItemCount DT_I4 int
SizeInBytes DT_I4 int
IsHidden DT_BOOL bit
If the column you are looking for is missing, consider customizing Outlook Mail (Office 365) Connector.

Input Columns

Label Data Type (SSIS) Data Type (SQL) Length 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 or in API Destination SSIS Data Flow components to read or write data.

API Source

This Endpoint belongs to the MyMailFolders table, therefore it is better to use it, instead of accessing the endpoint directly:

API Source - Outlook Mail (Office 365)
Outlook Mail Connector (Office 365) can be used to integrate Office 365 Outlook Mail API in your App / BI Tools. You can download attachment, read / search Emails, Users, MailFolders, Send email and more.
Outlook Mail (Office 365)
MyMailFolders
There are no parameters to configure.
SSIS API Source - Read from table or endpoint

API Destination

This Endpoint belongs to the MyMailFolders table, therefore it is better to use it, instead of accessing the endpoint directly. Use this table and table-operation pair to get my mail folders [only works with user credentials]:

API Destination - Outlook Mail (Office 365)
Outlook Mail Connector (Office 365) can be used to integrate Office 365 Outlook Mail API in your App / BI Tools. You can download attachment, read / search Emails, Users, MailFolders, Send email and more.
Outlook Mail (Office 365)
MyMailFolders
Select
There are no parameters to configure.
SSIS API Destination - Access table operation

ODBC application

Use these SQL queries in your ODBC application data source:

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 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).