Connectors / Service / Office365 Management

The Office 365 Management Activity service provides information about user, admin, system and policy actions and events from Office 365 and Azure AD activity logs. (updated: 1648562437204)

Office365 Management

The Office 365 Management Activity service provides information about a user, admin, system, and policy actions and events from Office 365 and Azure AD activity logs.

Overview

Office365 Management allows users to manage applications, services, data, devices, and users across Microsoft 365 services and Azure Active Directory (Azure AD) by providing audit activity logs.

API INFO: The Base URL used for the office365-management connector is https://manage.office.com/api/v1.0/common/activity/feed. More information can be found on their main API documentation (v1.0) site.

Below is an example of a way in which you could potentially use the Office365 Management connector to list current subscriptions and list the available content for each subscription.

The steps will be as follows:

  1. Setup using a manual trigger and List current subscriptions

  2. Add a Loop connector to iterate through the subscriptions found

  3. List the available content for each subscription, individually

Your completed workflow should look similar to this:

office365-management-complete-workflow1

1 - Setup Trigger & List current subscriptions

Select the Manual trigger from the trigger options available.

office365-management-step

After you have been redirected to the Tray.io workflow dashboard, from the connectors panel on the left, add an Office365 Management connector to your workflow. Set the operation to 'List current subscriptions'.

office365-management-step-operation

Feel free to re-name your steps as you go along to make things clearer for yourself and other users. The operation names themselves often suffice.

When run, this workflow will list all the current subscriptions under your Microsoft Azure credentials. You can also check the Debug panel for more details on the provided output:

office365-management-step-debug.png

2 - Loop and list available content

Next, search for the Loop connector within your connector panel, and drag it into your workflow as your next step. Set your operations to 'Loop list'.

The Loop connector allows you to iterate through a list of results. In this example, we will use it to iterate through the data found within the previous Office365 Management connector step.

In order to specify the list, you want to loop through, start by using the list mapping icon (found next to the list input field, within the properties panel) to generate the connector-snake.

While hovering over the 'List current subscriptions' step (with the tail end of the connector-snake), select results from the list of output properties displayed. This will auto-populate a jsonpath within your list input field, and update the type selector to jsonpath.

For more clarification on the pathways, you have available, open the Debug panel to view your step's Input and Output.

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray.io, please see our Intro page and Data Guide for more details.

CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

office365-management-step-loop

When run, this workflow will iterate through the list of current subscriptions provided by the earlier step.

The last step is to drag an Office365 Management connector inside of the Loop step itself. Set the operation to 'List available content'. As you can see, the 'contentType' field is required.

INTERPOLATION: When you wish to include JSON generated data within another input/output result, use our Interpolation method as described here.

office365-management-step3

When run, the workflow will now iterate through the list of current subscriptions and list the available content for each one.

BEST PRACTICES: Whenever you do decide to create your own workflow, please make sure you take a look at our managing data best practices guide.

All Operations

Latest version:

1.0

Create or update subscription

Starts a subscription to the specified content type. If a subscription to the specified content type already exists, this operation will update properties of an active webhook, enable/re-enable and remove a webhook.

List available content

Lists the content currently available for retrieval for the specified content type.

List current subscriptions

This operation returns a collection of the current subscriptions together with the associated webhooks.

Raw HTTP request (advanced)

Perform a raw HTTP request with some pre-configuration and processing by the connector, such as authentication.

Stop subscription

Stops a subscription to the specified content type.