Outlook Mail (Office 365) Connector
Documentation
Version: 3
Documentation
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 Label Required Options Description
OrderBy Order By NO
Option Value
None
AscendingOrder SomeColumn asc
DescendingOrder SomeColumn desc
Order the specified column by ascending or descending order [API reference]
SearchCriteria Search Criteria NO
Option Value
None
Equal Search SomeColumn eq 'SomeValue'
Substring Search substringof(SomeField,'abc')
Starts With startswith(SomeField, 'abc')
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
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 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:

Outlook Mail (Office 365)
MyMailFolders
Select
SSIS API Destination - Access table operation

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