Office 365 Groups Mail (Preview)

The Office 365 Groups Mail connector allows users to work with data located in an Office 365 Group mailbox. The functionality in this connector works independently from a single user's personal mailbox and allows users to work with any Group they can access within their organization. The connector works off the Microsoft Graph API, and uses terminology specified in the Office 365 Groups documentation within the Graph API. Learn more in the connector documentation.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
Power Automate Standard All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Power Apps Standard All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
Contact
Name Microsoft
URL Microsoft LogicApps Support
Microsoft Power Automate Support
Microsoft Power Apps Support
Connector Metadata
Publisher Microsoft
Website https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Categories productivity;mail;office

Prerequisites

In order to use this connector, you'll need a user account that has access to Office 365 Groups within an organization.

We also recommend that you review the Microsoft Graph API Documentation for Office 365 Groups to understand the way the data is structured within the API. There is key terminology that should be reviewed prior to using this connector, such as "conversation", "thread", and "post".

Known Issues and Limitations

Accessing "Public" Groups without membership

An authenticated user is able to access Group data from Groups they are a member of and any "Public" Group within their organization. In the connector experience, when selecting a Group, the connector offers a dynamic dropdown of Groups to select from. For a cleaner experience, this dropdown is automatically populated only with the Groups that the authenticated user is a member of.

To access "Public" Groups within your organization that are not populated in the dropdown, you'll need to provide the Group ID in the connector dropdown by scrolling to the very bottom and selecting Enter a custom value.

To find a Group ID within your organization, follow these steps:

  1. Navigate to Microsoft Graph Explorer and authenticate with your user on the top left.

  2. In the Sample queries section, select Groups, and then GET all groups in my organization.

  3. In the Response preview, find the Group within your organization that you're searching for. Provide the value in the id property as the custom value in the connector dropdown experience.

  4. Ensure the Group visibility is set to Public, or else the user will not be able to access the data within the Group.

  5. If you can't find the Group, you may need to look in the next page of results, which can be accessed by copying the link in @odata.nextLink and running it as a query at the top of the page.

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls160 seconds

Actions

Create a conversation thread

Create a new thread in the specified conversation.

Create a new conversation in a group

Create a new conversation in this group.

Delete a conversation thread

Deletes the specified conversation thread.

Forward a post

Forward a post to a recipient.

Get a conversation thread

Get a specific thread that belongs to a group.

Get a group conversation

Retrieves the properties of a particular conversation.

Get a thread post

Retrieves a post in a specified thread.

List the attachments of a post

Retrieve a list of attachments that belong to a post.

List the conversation threads of a conversation

Get all the threads in a group conversation.

List the conversations of a group

Get all the conversations in this group.

List the posts of a conversation thread

Get all the posts of the specified conversation thread.

List the threads of a group

Get all the threads of a group.

Reply to a conversation thread

Reply to a thread in a group conversation and add a new post to it.

Reply to a post

Reply to a post and add a new post to the specified thread in a group conversation.

Start a new group conversation by creating a thread

Start a new group conversation by first creating a thread.

Create a conversation thread

Create a new thread in the specified conversation.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Conversation ID
conversationId True string

Enter the conversation ID.

New topic
topic True string

Topic of the new conversation.

Content
content True html

Content of the new conversation.

Categories
Categories string

Pick a group from the drop down or enter group id.

address
address email

Email address.

Attachment name
Name True string

Name of the attachment.

Attachment content
ContentBytes True byte

Content of the attachment.

Returns

Create a new conversation in a group

Create a new conversation in this group.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

New topic
topic True string

Topic of the new conversation.

Content
content True html

Content of the new conversation.

Categories
Categories string

Pick a group from the drop down or enter group id.

address
address email

Email address.

Attachment name
Name True string

Name of the attachment.

Attachment content
ContentBytes True byte

Content of the attachment.

Returns

The response of with the created conversation details.

Created conversation object
CreateConversationResponse

Delete a conversation thread

Deletes the specified conversation thread.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Forward a post

Forward a post to a recipient.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Post ID
postId True string

Enter the post ID.

Comment
comment string

Comment to forward with the post.

address
address email

Email address.

Get a conversation thread

Get a specific thread that belongs to a group.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Returns

Conversation thread object.

Get a group conversation

Retrieves the properties of a particular conversation.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Conversation ID
conversationId True string

Enter the conversation ID.

Returns

Conversation object.

Get a thread post

Retrieves a post in a specified thread.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Post ID
postId True string

Enter the post ID.

Returns

Represents an individual Post item within a conversationThread entity.

Body
Post

List the attachments of a post

Retrieve a list of attachments that belong to a post.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Post ID
postId True string

Enter the post ID.

Returns

Name Path Type Description
value
value array of Attachment

Array containing the attachments of the post.

List the conversation threads of a conversation

Get all the threads in a group conversation.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Conversation ID
conversationId True string

Enter the conversation ID.

Returns

Name Path Type Description
value
value array of ConversationThread

List the conversations of a group

Get all the conversations in this group.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Returns

Name Path Type Description
value
value array of Conversation

List the posts of a conversation thread

Get all the posts of the specified conversation thread.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Returns

Name Path Type Description
value
value array of Post

Array containing the posts in the specified thread.

List the threads of a group

Get all the threads of a group.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Returns

Name Path Type Description
value
value array of ConversationThread

Reply to a conversation thread

Reply to a thread in a group conversation and add a new post to it.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Content
content True html

Content of the new conversation.

Categories
Categories string

Pick a group from the drop down or enter group id.

address
address email

Email address.

Attachment name
Name True string

Name of the attachment.

Attachment content
ContentBytes True byte

Content of the attachment.

Reply to a post

Reply to a post and add a new post to the specified thread in a group conversation.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Thread ID
threadId True string

Enter the conversation thread ID.

Post ID
postId True string

Enter the post ID.

Content
content True html

Content of the new conversation.

Categories
Categories string

Pick a group from the drop down or enter group id.

address
address email

Email address.

Attachment name
Name True string

Name of the attachment.

Attachment content
ContentBytes True byte

Content of the attachment.

Start a new group conversation by creating a thread

Start a new group conversation by first creating a thread.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

New topic
topic True string

Topic of the new conversation.

Content
content True html

Content of the new conversation.

Categories
Categories string

Pick a group from the drop down or enter group id.

address
address email

Email address.

Attachment name
Name True string

Name of the attachment.

Attachment content
ContentBytes True byte

Content of the attachment.

Returns

Triggers

When a new email arrives to a group

When a new email arrives to a group.

When a new email arrives to a group

When a new email arrives to a group.

Parameters

Name Key Required Type Description
Group ID
groupId True string

Pick a group from the drop down or enter group id.

Returns

Name Path Type Description
value
value array of ConversationTriggerResponse

Response of the trigger.

Definitions

Conversation

Conversation object.

Name Path Type Description
Conversation ID
id string

The conversations's unique identifier.

Conversation topic
topic string

The topic of the conversation.

Has attachments?
hasAttachments boolean

Indicates whether any of the posts within this Conversation has at least one attachment.

Last delivered timestamp
lastDeliveredDateTime date-time

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

Unique senders array
uniqueSenders array of string

All the users that sent a message to this Conversation.

Preview
preview string

A short summary from the body of the latest post in this Conversation.

ConversationThread

Conversation thread object.

Name Path Type Description
Conversation thread ID
id string

The conversation thread's unique identifier.

Conversation topic
topic string

The topic of the conversation.

Has attachments?
hasAttachments boolean

Indicates whether any of the posts within this Conversation has at least one attachment.

Last delivered timestamp
lastDeliveredDateTime date-time

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

Unique senders array
uniqueSenders array of string

All the users that sent a message to this Conversation.

Preview
preview string

A short summary from the body of the latest post in this Conversation.

Is Locked?
isLocked boolean

Indicates if the thread is locked.

toRecipients
toRecipients array of EmailAddress

The To: recipients for the thread.

ccRecipients
ccRecipients array of EmailAddress

The Cc: recipients for the thread.

Post

Represents an individual Post item within a conversationThread entity.

Name Path Type Description
Post ID
id string

The post's unique identifier.

Created timestamp of the post
createdDateTime date-time
Last modified timestamp of the post
lastModifiedDateTime date-time
Change Key
changeKey string

Identifies the version of the post.

Conversation ID
conversationId string

Unique ID of the conversation the post belongs to.

Conversation thread ID
conversationThreadId string

Unique ID of the conversation thread the post belongs to.

Categories
categories array of string

The categories associated with the post.

Received timestamp
receivedDateTime date-time

Post received timestamp.

Has attachments?
hasAttachments boolean

Indicates whether the post has at least one attachment.

New participants
newParticipants array of EmailAddress

Conversation participants that were added to the thread as part of this post.

body
body ItemBody

Represents properties of the body of an item, such as a message, event or group post.

from
from EmailAddress
sender
sender EmailAddress
attachments
attachments array of Attachment

Attachment

Name Path Type Description
Attachment ID
id string

Id of the attachment.

Attachment name
name string

Name of attachment.

Attachment content Type
contentType string

Content type of attachment.

Attachment size
size integer

Size of attachment.

Attachment content bytes
contentBytes byte

Content of attachment.

EmailAddress

Name Path Type Description
Name of the user
emailAddress.name string
Email address of the user
emailAddress.address email

ItemBody

Represents properties of the body of an item, such as a message, event or group post.

Name Path Type Description
Body content type
contentType string

Content type of the body.

Body content
content string

Content of the body.

CreateConversationResponse

The response of with the created conversation details.

Name Path Type Description
Conversation ID
id string

New Conversation ID.

Conversation threads
threads array of object

Created conversation thread.

Thread ID
threads.id string

The new thread ID.

NewConversationThreadResponse

Name Path Type Description
Conversation thread ID
id string

New conversation thread ID.

ConversationTriggerResponse

When a new email arrives trigger response.

Name Path Type Description
Conversation ID
id string

The conversation unique identifier.

Last delivered timestamp
lastDeliveredDateTime date-time

The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time.

threads
threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Conversation thread object.

Name Path Type Description
Conversation thread ID
id string

The conversation thread's unique identifier.

posts
posts array of PostTriggerResponse

PostTriggerResponse

Represents an individual Post item within a conversationThread entity.

Name Path Type Description
Post ID
id string

The post's unique identifier.

Last modified timestamp of the post
lastModifiedDateTime date-time
Change Key
changeKey string

Identifies the version of the post.