Microsoft Outlook Component

Read and manage Microsoft Outlook calendars and email

Component key: ms-outlook

Description

Microsoft Outlook is a productivity suite for managing email and calendar.

Connections

OAuth 2.0 Authorization Code

You will first need to create and configure a new "App Registration" within your Azure Active Directory tenant. When creating the application you will be prompted to select the 'Supported account types'. Under this section, be sure to select 'Accounts in any organizational directory (Any Azure AD directory - Multitenant)'.

You will need to go to "Platforms" and add the "Web" platform. In that section you should add Prismatic's OAuth 2.0 callback URL - https://oauth2.prismatic.io/callback - as a Redirect URI.

Next, go to "Certificates & Secrets" for the app and add a new Client Secret. Note this value as you will need to supply it to the connection within Prismatic.

You will also need the Application (client) ID from the "Overview" page.

Now, configure the OAuth 2.0 connection in Prismatic. Add an Microsoft Outlook OAuth 2.0 connection config variable:

Use the Application (client) ID value for the Client ID field.
Use the Client Secret for the same named field.
If you didn't select Multitenant when creating the Azure application, you will need to replace the Authorize URL and Token URL with ones specific to your tenant.
The default scopes are as follows. You can remove scopes that you don't need:
- https://graph.microsoft.com/User.Read for reading basic user data
- https://graph.microsoft.com/Calendars.ReadWrite for managing Outlook calendar
- https://graph.microsoft.com/Mail.ReadWrite for managing email
- https://graph.microsoft.com/Mail.Send for sending email

Save your integration and you should be able to authenticate a user with OAuth 2.0 to access their Microsoft Outlook data.

Input	Default	Notes
Authorize URL string / Required authorizeUrl	https://login.microsoftonline.com/common/oauth2/v2.0/authorize?prompt=consent	The OAuth 2.0 Authorization URL for Microsoft Outlook
Client ID string / Required clientId
Client secret value password / Required clientSecret
Scopes string scopes	https://graph.microsoft.com/User.Read https://graph.microsoft.com/Calendars.ReadWrite https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send offline_access	Microsoft Outlook permission scopes are set on the OAuth application
Token URL string / Required tokenUrl	https://login.microsoftonline.com/common/oauth2/v2.0/token	The OAuth 2.0 Token URL for Microsoft Outlook

Triggers

Webhook

Receive and validate webhook requests from Outlook for webhooks you configure. | key: webhook

Actions

Cancel Event

Cancel an Event | key: cancelEvent

Input	Notes
Comment string comment	Comment about the cancellation sent to all attendees
Connection connection / Required connection
Event ID string / Required eventId	Event ID to manipulate

Example Payload for Cancel Event

{
  "data": ""
}

Create Calendar

Create a new Calendar | key: createCalendar

Input	Default	Notes	Example
Color string / Required color	auto	Color of the Calendar; see 'color' at https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#properties for details	lightRed
Connection connection / Required connection
Name string / Required name		Name of the Calendar

Example Payload for Create Calendar

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('266efe5a-0fd7-4edd-877b-b2d1e561f193@ae01a323-3934-4475-a32d-af1274312bb0')/calendars('AAMkADJmMVAAA=')",
    "id": "AAMkADJmMVAAA=",
    "name": "Volunteer",
    "color": "auto",
    "changeKey": "DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
    "canShare": true,
    "canViewPrivateItems": true,
    "hexColor": "",
    "canEdit": true,
    "allowedOnlineMeetingProviders": [
      "teamsForBusiness"
    ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": false,
    "owner": {
      "name": "Samantha Booth",
      "address": "samanthab@adatum.onmicrosoft.com"
    }
  }
}

Create Event

Create an Event on a Calendar | key: createEvent

Input	Default	Notes	Example
Type string Key Value List attendees		Attendees of the Event
Attendees Data Collection data attendeesData		Field for references to data structures representing attendees. Will be merged with Attendees if both are specified.	[{ emailAddress: { address: 'example@example.com', name: 'Example Name' }, type: 'required' }]
Body (HTML) string / Required body		HTML Body of the Event
Calendar ID string calendarId		Calendar ID to list Events of; will list all events for current user if unspecified
Connection connection / Required connection
End At string / Required end		ISO formatted timestamp without timezone information	2017-04-15T14:00:00
End Timezone string / Required endTimezone	UTC	Timezone for the End time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time
Location Name string / Required locationName		Name of the Location
Start At string / Required start		ISO formatted timestamp without timezone information	2017-04-15T12:00:00
Start Timezone string / Required startTimezone	UTC	Timezone for the Start time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time
Subject string / Required subject		Subject of the Event

Example Payload for Create Event

{
  "data": {
    "subject": "Let's go for lunch",
    "body": {
      "contentType": "html",
      "content": "Does noon work for you?"
    },
    "start": {
      "dateTime": "2017-04-15T12:00:00",
      "timeZone": "Pacific Standard Time"
    },
    "end": {
      "dateTime": "2017-04-15T14:00:00",
      "timeZone": "Pacific Standard Time"
    },
    "location": {
      "displayName": "Harry's Bar"
    },
    "attendees": [
      {
        "emailAddress": {
          "address": "samanthab@contoso.onmicrosoft.com",
          "name": "Samantha Booth"
        },
        "type": "required"
      }
    ],
    "allowNewTimeProposals": true,
    "transactionId": "7E163156-7762-4BEB-A1C6-729EA81755A7"
  }
}

Create Event Subscription

Create an Event subscription for Microsoft Outlook | key: createEventSubscription

Input	Default	Notes
Allow Duplicates boolean allowDuplicates	false	Enable to allow more than one webhook per endpoint
Connection connection / Required connection
Expiration Date/Time string expirationDateTime		Expiration date/time for subscription. If unspecified the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).
Notification URL string / Required notificationUrl		URL to send events of this Subscription to

Create Mail Folder

Create a new mail folder | key: createMailFolder

Input	Notes
Connection connection / Required connection
Display name string / Required name
Parent Folder ID string parentFolderId	Create a folder under this parent folder. Omit to create a root-level folder.

Example Payload for Create Mail Folder

{
  "data": {
    "displayName": "displayName-value",
    "parentFolderId": "parentFolderId-value",
    "childFolderCount": 0,
    "unreadItemCount": 0,
    "totalItemCount": 0,
    "id": "id-value",
    "isHidden": true
  }
}

Create Mail Folder Subscription

Create a Mail Folder subscription for Microsoft Outlook | key: createMailFolderSubscription

Input	Notes
Mail Change Types string / Required Value List changeType	The type of change to listen for
Connection connection / Required connection
Expiration Date/Time string expirationDateTime	Expiration date/time for subscription. If unspecified the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).
Notification URL string / Required notificationUrl	URL to send events of this Subscription to

Delete All Instance Subscriptions

Delete all subscriptions pointed at this instance | key: deleteAllInstanceSubscriptions

Input	Notes
Connection connection / Required connection

Example Payload for Delete All Instance Subscriptions

{
  "data": {
    "subscriptionsRemoved": [
      "26ebd1e9-c54a-4bbe-9583-fc05974952a4",
      "b9b27172-ee2e-4248-86df-fc98cb71d914"
    ]
  }
}

Delete Calendar

Delete an existing Calendar | key: deleteCalendar

Input	Notes
Connection connection / Required connection
Calendar ID string / Required id	ID of the Calendar to modify

Example Payload for Delete Calendar

{
  "data": ""
}

Delete Event

Delete an Event | key: deleteEvent

Input	Notes
Connection connection / Required connection
Event ID string / Required eventId	Event ID to manipulate

Example Payload for Delete Event

{
  "data": ""
}

Delete Mail Folder

Delete the specified mail folder | key: deleteMailFolder

Input	Notes
Connection connection / Required connection
Folder ID string / Required folderId

Example Payload for Delete Mail Folder

{
  "data": null
}

Delete Message

Delete message by ID | key: deleteMessage

Input	Notes
Connection connection / Required connection
Message ID string / Required messageId	The ID of a mail message

Example Payload for Delete Message

{
  "data": null
}

Delete Subscription

Delete existing subscription for Microsoft Outlook | key: deleteSubscription

Input	Notes
Connection connection / Required connection
Subscription ID string / Required subscriptionId	Subscription ID to manage

Example Payload for Delete Subscription

{
  "data": ""
}

Get Current User

Get the information and metadata of the user that is currently logged in | key: getCurrentUser

Input	Notes
Connection connection / Required connection

Example Payload for Get Current User

{
  "data": {
    "businessPhones": [
      "+1 555 555 5555"
    ],
    "displayName": "exampleUser",
    "givenName": "exampleUser",
    "jobTitle": "Retail Manager",
    "mail": "someoneV@example.onmicrosoft.com",
    "mobilePhone": "+1 555 555 5555",
    "officeLocation": "example",
    "preferredLanguage": "en-US",
    "surname": "Example",
    "id": "3693-4789-a1c3-f4de565f"
  }
}

Get Mail Message

Fetch and parse a raw message by ID | key: getMessageById

Input	Notes
Connection connection / Required connection
Message ID string / Required messageId	The ID of a mail message

Example Payload for Get Mail Message

{
  "data": {
    "message": {
      "headers": {
        "mime-version": "1.0",
        "date": "2022-09-19T20:09:01.000Z",
        "message-id": "<Test-message-id@mail.outlook.com>",
        "subject": "Test Message",
        "from": {
          "value": [
            {
              "address": "example@outlook.com",
              "name": "Example Example"
            }
          ],
          "html": "<span class=\"mp_address_group\"><span class=\"mp_address_name\">Example Example</span> &lt;<a href=\"mailto:example@gmail.com\" class=\"mp_address_email\">example@gmail.com</a>&gt;</span>",
          "text": "Example Example <example@outlook.com>"
        },
        "to": {
          "value": [
            {
              "address": "example@outlook.com",
              "name": "Example Example"
            }
          ],
          "html": "<span class=\"mp_address_group\"><span class=\"mp_address_name\">Example Example</span> &lt;<a href=\"mailto:example@gmail.com\" class=\"mp_address_email\">example@gmail.com</a>&gt;</span>",
          "text": "Example Example <example@outlook.com>"
        },
        "content-type": {
          "value": "multipart/mixed",
          "params": {
            "boundary": "000000000000680fa005e90d488f"
          }
        }
      },
      "attachments": [],
      "text": "Example email body",
      "html": "<div dir=\"ltr\">Example email body<div><br></div></div>\n"
    },
    "rawMessage": "Raw MIME message"
  }
}

Get Schedule Availability

Get the free/busy availability information for a collection of users | key: getSchedule

Input	Default	Notes	Example
Availability View Interval string availabilityViewInterval	30	Duration of time slot to check availability for in minutes	60
Connection connection / Required connection
End At string / Required end		ISO formatted timestamp without timezone information	2017-04-15T14:00:00
End Timezone string / Required endTimezone	UTC	Timezone for the End time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time
Schedules string / Required Value List schedules		Collection of SMTP addresses of users, distribution lists, or resources to get availability information for	example@example.com
Start At string / Required start		ISO formatted timestamp without timezone information	2017-04-15T12:00:00
Start Timezone string / Required startTimezone	UTC	Timezone for the Start time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time

Example Payload for Get Schedule Availability

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.scheduleInformation)",
    "value": [
      {
        "scheduleId": "adelev@contoso.onmicrosoft.com",
        "availabilityView": "000220000",
        "scheduleItems": [
          {
            "isPrivate": false,
            "status": "busy",
            "subject": "Let's go for lunch",
            "location": "Harry's Bar",
            "start": {
              "dateTime": "2019-03-15T12:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T14:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          }
        ],
        "workingHours": {
          "daysOfWeek": [
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday"
          ],
          "startTime": "08:00:00.0000000",
          "endTime": "17:00:00.0000000",
          "timeZone": {
            "name": "Pacific Standard Time"
          }
        }
      },
      {
        "scheduleId": "meganb@contoso.onmicrosoft.com",
        "availabilityView": "200220010",
        "scheduleItems": [
          {
            "status": "busy",
            "start": {
              "dateTime": "2019-03-15T08:30:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T09:30:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          },
          {
            "status": "busy",
            "start": {
              "dateTime": "2019-03-15T12:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T14:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          },
          {
            "status": "tentative",
            "start": {
              "dateTime": "2019-03-15T12:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T13:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          },
          {
            "status": "busy",
            "start": {
              "dateTime": "2019-03-15T13:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T14:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          },
          {
            "status": "tentative",
            "start": {
              "dateTime": "2019-03-15T16:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            },
            "end": {
              "dateTime": "2019-03-15T17:00:00.0000000",
              "timeZone": "Pacific Standard Time"
            }
          }
        ],
        "workingHours": {
          "daysOfWeek": [
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday"
          ],
          "startTime": "08:00:00.0000000",
          "endTime": "17:00:00.0000000"
        }
      }
    ]
  }
}

List Calendars

List all Calendars for the user | key: listCalendars

Input	Notes	Example
Connection connection / Required connection
Page Limit string pageLimit	Enter number for desired page size.	100
Page Skip string pageSkip	Enter number of records to skip.	100

Example Payload for List Calendars

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars",
    "value": [
      {
        "@odata.id": "https://graph.microsoft.com/v1.0/users('ddfcd489-628b-40d7-b48b-57002df800e5@1717622f-1d94-4d0c-9d74-709fad664b77')/calendars('AAMkAGI2TGuLAAA=')",
        "id": "AAMkAGI2TGuLAAA=",
        "name": "Calendar",
        "color": "auto",
        "changeKey": "nfZyf7VcrEKLNoU37KWlkQAAA0x0+w==",
        "canShare": true,
        "canViewPrivateItems": true,
        "hexColor": "",
        "canEdit": true,
        "allowedOnlineMeetingProviders": [
          "teamsForBusiness"
        ],
        "defaultOnlineMeetingProvider": "teamsForBusiness",
        "isTallyingResponses": true,
        "isRemovable": false,
        "owner": {
          "name": "Samantha Booth",
          "address": "samanthab@adatum.onmicrosoft.com"
        }
      }
    ]
  }
}

List Events

List all Events for the user | key: listEvents

Input	Notes	Example
Calendar ID string calendarId	Calendar ID to list Events of; will list all events for current user if unspecified
Connection connection / Required connection
Page Limit string pageLimit	Enter number for desired page size.	100
Page Skip string pageSkip	Enter number of records to skip.	100

Example Payload for List Events

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('cd209b0b-3f83-4c35-82d2-d88a61820480')/events(subject,body,bodyPreview,organizer,attendees,start,end,location)",
    "value": [
      {
        "@odata.etag": "W/\"ZlnW4RIAV06KYYwlrfNZvQAAKGWwbw==\"",
        "id": "AAMkAGIAAAoZDOFAAA=",
        "subject": "Orientation ",
        "bodyPreview": "Dana, this is the time you selected for our orientation. Please bring the notes I sent you.",
        "body": {
          "contentType": "html",
          "content": "<html><head></head><body><p>Dana, this is the time you selected for our orientation. Please bring the notes I sent you.</p></body></html>"
        },
        "start": {
          "dateTime": "2017-04-21T10:00:00.0000000",
          "timeZone": "Pacific Standard Time"
        },
        "end": {
          "dateTime": "2017-04-21T12:00:00.0000000",
          "timeZone": "Pacific Standard Time"
        },
        "location": {
          "displayName": "Assembly Hall",
          "locationType": "default",
          "uniqueId": "Assembly Hall",
          "uniqueIdType": "private"
        },
        "locations": [
          {
            "displayName": "Assembly Hall",
            "locationType": "default",
            "uniqueIdType": "unknown"
          }
        ],
        "attendees": [
          {
            "type": "required",
            "status": {
              "response": "none",
              "time": "0001-01-01T00:00:00Z"
            },
            "emailAddress": {
              "name": "Samantha Booth",
              "address": "samanthab@a830edad905084922E17020313.onmicrosoft.com"
            }
          },
          {
            "type": "required",
            "status": {
              "response": "none",
              "time": "0001-01-01T00:00:00Z"
            },
            "emailAddress": {
              "name": "Dana Swope",
              "address": "danas@a830edad905084922E17020313.onmicrosoft.com"
            }
          }
        ],
        "organizer": {
          "emailAddress": {
            "name": "Samantha Booth",
            "address": "samanthab@a830edad905084922E17020313.onmicrosoft.com"
          }
        }
      }
    ]
  }
}

List Mail Folders

Get the mail folder collection directly under the root folder of the signed-in user, or under the specified parent folder. | key: listMailFolders

Input	Notes	Example
Connection connection / Required connection
Page Limit string pageLimit	Enter number for desired page size.	100
Page Skip string pageSkip	Enter number of records to skip.	100
Parent Folder ID string parentFolderId	List all folders contained within this folder. Omit to list root-level folders.

Example Payload for List Mail Folders

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('68ca8ec0-11f8-456b-a785-70d9936650d5')/mailFolders",
    "value": [
      {
        "id": "AQMkADYAAAIBCgAAAA==",
        "displayName": "Deleted Items",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 0,
        "totalItemCount": 0,
        "isHidden": false
      },
      {
        "id": "AQMkADYAAAIBDwAAAA==",
        "displayName": "Drafts",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 0,
        "totalItemCount": 0,
        "isHidden": false
      },
      {
        "id": "AQMkADYAAAIBDAAAAA==",
        "displayName": "Inbox",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 1,
        "unreadItemCount": 70,
        "totalItemCount": 71,
        "isHidden": false
      },
      {
        "@odata.type": "#microsoft.graph.mailSearchFolder",
        "id": "AAMkADYRAAAZg1yTAAA=",
        "displayName": "Weekly digests",
        "parentFolderId": "AQMkADYAAAIBDAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 4,
        "totalItemCount": 5,
        "isHidden": false,
        "isSupported": true,
        "filterQuery": "contains(subject, 'weekly digest')"
      },
      {
        "id": "AQMkADYAAAIBGQAAAA==",
        "displayName": "Junk Email",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 0,
        "totalItemCount": 0,
        "isHidden": false
      },
      {
        "id": "AQMkADYAAAIBCwAAAA==",
        "displayName": "Outbox",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 0,
        "totalItemCount": 0,
        "isHidden": false
      },
      {
        "id": "AQMkADYAAAIBCQAAAA==",
        "displayName": "Sent Items",
        "parentFolderId": "AQMkADYAAAIBCAAAAA==",
        "childFolderCount": 0,
        "unreadItemCount": 0,
        "totalItemCount": 0,
        "isHidden": false
      }
    ]
  }
}

List Mail Messages

List mail messages in a user's mailbox | key: listMessages

Input	Notes	Example
Connection connection / Required connection
Folder ID string folderId	The folder to list messages for. Omit to list all messages.
Page Limit string pageLimit	Enter number for desired page size.	100
Page Skip string pageSkip	Enter number of records to skip.	100

Example Payload for List Mail Messages

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('bb8775a4-4d8c-42cf-a1d4-4d58c2bb668f')/messages(sender,subject)",
    "value": [
      {
        "@odata.etag": "W/\"CQAAABYAAADHcgC8Hl9tRZ/hc1wEUs1TAAAwR4Hg\"",
        "id": "AAMkAGUAAAwTW09AAA=",
        "subject": "You have late tasks!",
        "sender": {
          "emailAddress": {
            "name": "Microsoft Planner",
            "address": "noreply@Planner.Office365.com"
          }
        }
      }
    ]
  }
}

List Subscriptions

List all subscriptions for Microsoft Outlook | key: listSubscriptions

Input	Default	Notes
Connection connection / Required connection
Show Instance Webhooks boolean / Required showInstanceWebhooks	true	Show only subscriptions for this Instance's webhooks

List Supported Languages

List supported languages for current user | key: listSupportedLanguages

Input	Notes
Connection connection / Required connection

List Supported Timezones

List supported timezones for current user | key: listSupportedTimezones

Input	Notes
Connection connection / Required connection

Raw Request

Send raw HTTP request to Microsoft Outlook | key: rawRequest

Input	Default	Notes	Example
Connection connection / Required connection
Data string data		The HTTP body payload to send to the URL.	{"exampleKey": "Example Data"}
Debug Request boolean debugRequest	false	Enabling this flag will log out the current request.
File Data string Key Value List fileData		File Data to be sent as a multipart form upload.	[{key: "example.txt", value: "My File Contents"}]
File Data File Names string Key Value List fileDataFileNames		File names to apply to the file data inputs. Keys must match the file data keys above.
Form Data string Key Value List formData		The Form Data to be sent as a multipart form upload.	[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header string Key Value List headers		A list of headers to send with the request.	User-Agent: curl/7.64.1
Max Retry Count string maxRetries	0	The maximum number of retries to attempt.
Method string / Required method		The HTTP method to use.
Query Parameter string Key Value List queryParams		A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Response Type string / Required responseType	json	The type of data you expect in the response. You can request json, text, or binary data.
Retry On All Errors boolean retryAllErrors	false	If true, retries on all erroneous responses regardless of type.
Retry Delay (ms) string retryDelayMS	0	The delay in milliseconds between retries.
Timeout string timeout		The maximum time that a client will await a response to its request	2000
URL string / Required url		Input the path only (/me/calendars), The base URL is already included (https://graph.microsoft.com/v1.0). For example, to connect to https://graph.microsoft.com/v1.0/me/calendars, only /me/calendars is entered in this field.	/me/calendars
Use Exponential Backoff boolean useExponentialBackoff	false	Specifies whether to use a pre-defined exponential backoff strategy for retries.

Send Message

Send a new message | key: sendMessage

Input	Default	Notes	Example
Attachments string Key Value List attachments		Specify a file name as the key (i.e. my-file.pdf), and the file as the value	{ "my-file.pdf": { "type": "Buffer", "data": [ 102, 105, 108, 101, 32, 99, 111, 110, 116, 101, 110, 116 ] } }
BCC string Value List bcc		You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'
Message Body string body		Plain text or HTML body
Body Content Type string / Required bodyContentType	html
CC string Value List cc		You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'
Connection connection / Required connection
Dynamic Attachments data dynamicAttachments		An array of objects with "key" and "value" properties, where "key" is the file name and "value" is the binary file data. Typically used as a reference from a previous step. Ex. [{"key":"my-attachment.pdf","value":"<BINARY FILE DATA TO ATTACH>"},{"key":"another-attachment.xlsx","value":"<BINARY EXCEL FILE DATA>"}]	[ { "key": "my-attachment.pdf", "value": "<BINARY FILE DATA TO ATTACH>" }, { "key": "another-attachment.xlsx", "value": "<BINARY EXCEL FILE DATA>" } ]
Subject string / Required subject
To string / Required Value List to		You can specify multiple addresses separated by commas. i.e. 'john@example.com' or 'john@example.com,sally@example.com'

Update Calendar

Update an existing Calendar | key: updateCalendar

Input	Default	Notes	Example
Color string / Required color	auto	Color of the Calendar; see 'color' at https://learn.microsoft.com/en-us/graph/api/resources/calendar?view=graph-rest-1.0#properties for details	lightRed
Connection connection / Required connection
Calendar ID string / Required id		ID of the Calendar to modify
Name string name		Name of the Calendar

Example Payload for Update Calendar

{
  "data": {
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#me/calendars/$entity",
    "@odata.id": "https://graph.microsoft.com/v1.0/users('266efe5a-0fd7-4edd-877b-b2d1e561f193@ae01a323-3934-4475-a32d-af1274312bb0')/calendars('AAMkADJmMVAAA=')",
    "id": "AAMkADJmMVAAA=",
    "name": "Social events",
    "color": "auto",
    "isDefaultCalendar": false,
    "changeKey": "DxYSthXJXEWwAQSYQnXvIgAAIxGttg==",
    "canShare": true,
    "canViewPrivateItems": true,
    "hexColor": "",
    "canEdit": true,
    "allowedOnlineMeetingProviders": [
      "teamsForBusiness"
    ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": false,
    "owner": {
      "name": "Samantha Booth",
      "address": "samanthab@adatum.onmicrosoft.com"
    }
  }
}

Update Event

Update an existing Event | key: updateEvent

Input	Default	Notes	Example
Type string Key Value List attendees		Attendees of the Event
Attendees Data Collection data attendeesData		Field for references to data structures representing attendees. Will be merged with Attendees if both are specified.	[{ emailAddress: { address: 'example@example.com', name: 'Example Name' }, type: 'required' }]
Body (HTML) string body		HTML Body of the Event
Connection connection / Required connection
End At string end		ISO formatted timestamp without timezone information	2017-04-15T14:00:00
End Timezone string endTimezone	UTC	Timezone for the End time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time
Event ID string / Required eventId		Event ID to manipulate
Location Name string locationName		Name of the Location
Start At string start		ISO formatted timestamp without timezone information	2017-04-15T12:00:00
Start Timezone string startTimezone	UTC	Timezone for the Start time of the Event; use the List Supported Timezones action for details on valid aliases/values for this user	Pacific Standard Time
Subject string subject		Subject of the Event

Example Payload for Update Event

{
  "data": {
    "subject": "Let's go for lunch",
    "body": {
      "contentType": "html",
      "content": "Does noon work for you?"
    },
    "start": {
      "dateTime": "2017-04-15T12:00:00",
      "timeZone": "Pacific Standard Time"
    },
    "end": {
      "dateTime": "2017-04-15T14:00:00",
      "timeZone": "Pacific Standard Time"
    },
    "location": {
      "displayName": "Harry's Bar"
    },
    "attendees": [
      {
        "emailAddress": {
          "address": "samanthab@contoso.onmicrosoft.com",
          "name": "Samantha Booth"
        },
        "type": "required"
      }
    ],
    "allowNewTimeProposals": true,
    "transactionId": "7E163156-7762-4BEB-A1C6-729EA81755A7"
  }
}

Update Event Subscription Expiration

Update existing Event subscription expiration for Microsoft Outlook | key: updateEventSubscription

Input	Notes
Connection connection / Required connection
Expiration Date/Time string expirationDateTime	Expiration date/time for subscription. If unspecified the default will be the current date/time plus 10070 minutes (close to the maximum permitted by the Graph API).
Subscription ID string / Required subscriptionId	Subscription ID to manage

Read and manage Microsoft Outlook calendars and email

Description​

Connections​

OAuth 2.0 Authorization Code​

Triggers​

Webhook​

Actions​

Cancel Event​

Create Calendar​

Create Event​

Create Event Subscription​

Create Mail Folder​

Create Mail Folder Subscription​

Delete All Instance Subscriptions​

Delete Calendar​

Delete Event​

Delete Mail Folder​

Delete Message​

Delete Subscription​

Get Current User​

Get Mail Message​

Get Schedule Availability​

List Calendars​

List Events​

List Mail Folders​

List Mail Messages​

List Subscriptions​

List Supported Languages​

List Supported Timezones​

Raw Request​

Send Message​

Update Calendar​

Update Event​

Update Event Subscription Expiration​