Reference

Endpoint Get Mail Folder by Id [only works with User Credentials]


Name

get_my_mailfolder

Description

Get the mail folder specified by the mail folder Id. [API reference]

Related Tables

MyMailFolders

Parameters

Parameter Required Options
Name: MailFolderId

Label: Mail Folder Id

The Microsoft Mail mail folder ID for the mail folder.
YES
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
Required Parameters
Mail Folder Id Fill-in the parameter...
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 mail folder by id [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
Lookup
Required Parameters
Mail Folder Id Fill-in the parameter...
SSIS API Destination - Access table operation

ODBC application

Use these SQL queries in your ODBC application data source:

Get a specific mail folder associated with the current user by its mail folder ID

SELECT * FROM MyMailFolders
WHERE (Id='AAMkADIwNzNhODMyLTZiMTQtNDhiMCz4OWQzLTc5YTY5M2IyMjk0NAYuAAAAAACbj2hVuNphT74wyYrfU4ixAQAbUV6IxRnpQrWzrb2WfacdAAAAAAEKAcA=')

get_my_mailfolder 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 a specific mail folder associated with the current user by its mail folder ID

DECLARE @MyQuery NVARCHAR(MAX) = 'SELECT * FROM MyMailFolders
WHERE (Id=''AAMkADIwNzNhODMyLTZiMTQtNDhiMCz4OWQzLTc5YTY5M2IyMjk0NAYuAAAAAACbj2hVuNphT74wyYrfU4ixAQAbUV6IxRnpQrWzrb2WfacdAAAAAAEKAcA='')';

EXEC (@MyQuery) AT [LS_TO_OUTLOOK_MAIL_OFFICE_365_IN_GATEWAY];

get_my_mailfolder endpoint belongs to MyMailFolders table(s), and can therefore be used via those table(s).