Microsoft Outlook

Node: microsoftOutlook · Full type: n8n-nodes-base.microsoftOutlook · Version: 2

Credentials

microsoftOutlookOAuth2Api (alias: @microsoft)

CREDENTIAL @microsoft = microsoftOutlookOAuth2Api "My Microsoft Outlook"

Operations

Resource: calendar

create

Parameter	Type	Default	Details
name	string	""	required
additionalFields	collection	{}	keys: calendarGroup, color

delete

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id

get

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id

getAll

Parameter	Type	Default	Details
returnAll	boolean	false
limit	number	100
filters	collection	{}	keys: custom

update

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id
updateFields	collection	{}	keys: color, isDefaultCalendar, name

Resource: contact

create

Parameter	Type	Default	Details
givenName	string	""	required
surname	string	""
additionalFields	collection	{}	keys: assistantName, birthday, businessAddress, businessHomePage, businessPhones, categories, ...

delete

Parameter	Type	Default	Details
contactId	resourceLocator	{...}	required; modes: list, id

get

Parameter	Type	Default	Details
contactId	resourceLocator	{...}	required; modes: list, id
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: createdDateTime, lastModifiedDateTime, changeKey, categories, parentFolderId, birthday, fileAs, displayName, ... (37 total)

getAll

Parameter	Type	Default	Details
returnAll	boolean	false
limit	number	100
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: createdDateTime, lastModifiedDateTime, changeKey, categories, parentFolderId, birthday, fileAs, displayName, ... (37 total)
filters	collection	{}	keys: custom, emailAddress

update

Parameter	Type	Default	Details
contactId	resourceLocator	{...}	required; modes: list, id
additionalFields	collection	{}	keys: assistantName, birthday, businessAddress, businessHomePage, businessPhones, categories, ...

Resource: draft

create

Parameter	Type	Default	Details
subject	string	""
bodyContent	string	""
additionalFields	collection	{}	keys: attachments, bccRecipients, categories, ccRecipients, internetMessageHeaders, from, ...

delete

Parameter	Type	Default	Details
draftId	resourceLocator	{...}	required; modes: list, id

get

Parameter	Type	Default	Details
draftId	resourceLocator	{...}	required; modes: list, id
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, ... (27 total)
options	collection	{}	keys: attachmentsPrefix, downloadAttachments

send

Parameter	Type	Default	Details
draftId	resourceLocator	{...}	required; modes: list, id
to	string	""

update

Parameter	Type	Default	Details
draftId	resourceLocator	{...}	required; modes: list, id
updateFields	collection	{}	keys: bccRecipients, categories, ccRecipients, internetMessageHeaders, from, importance, ...

Resource: event

create

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id
subject	string	""	required
startDateTime	dateTime	"2026-03-14T17:50:10.028+02:00"	required
endDateTime	dateTime	"2026-03-14T18:20:10.028+02:00"	required
additionalFields	collection	{}	keys: categories, body, bodyPreview, hideAttendees, importance, isAllDay, ...

delete

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id
eventId	resourceLocator	{...}	required; modes: list, url, id

get

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id
eventId	resourceLocator	{...}	required; modes: list, url, id
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: allowNewTimeProposals, attendees, body, bodyPreview, categories, changeKey, createdDateTime, end, ... (39 total)

getAll

Parameter	Type	Default	Details
fromAllCalendars	boolean	true
calendarId	resourceLocator	{...}	required; modes: list, id
returnAll	boolean	false
limit	number	100
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: allowNewTimeProposals, attendees, body, bodyPreview, categories, changeKey, createdDateTime, end, ... (39 total)
filters	collection	{}	keys: custom

update

Parameter	Type	Default	Details
calendarId	resourceLocator	{...}	required; modes: list, id
eventId	resourceLocator	{...}	required; modes: list, url, id
additionalFields	collection	{}	keys: categories, body, bodyPreview, end, hideAttendees, importance, ...

Resource: folder

create

Parameter	Type	Default	Details
displayName	string	""	required
options	collection	{}	keys: folderId

delete

Parameter	Type	Default	Details
folderId	resourceLocator	{...}	required; modes: list, url, id

get

Parameter	Type	Default	Details
folderId	resourceLocator	{...}	required; modes: list, url, id
options	collection	{}	keys: fields

getAll

Parameter	Type	Default	Details
returnAll	boolean	false
limit	number	100
filters	collection	{}	keys: filter
options	collection	{}	keys: fields, includeChildFolders, folderId

update

Parameter	Type	Default	Details
folderId	resourceLocator	{...}	required; modes: list, url, id
displayName	string	""	required

Resource: folderMessage

getAll

Parameter	Type	Default	Details
folderId	resourceLocator	{...}	required; modes: list, url, id
returnAll	boolean	false
limit	number	100
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, ... (27 total)
filtersUI	fixedCollection	{}	groups: values
options	collection	{}	keys: attachmentsPrefix, downloadAttachments

Resource: message

delete

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id

get

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, ... (27 total)
options	collection	{}	keys: attachmentsPrefix, downloadAttachments, getMimeContent

getAll

Parameter	Type	Default	Details
returnAll	boolean	false
limit	number	100
output	options	"simple"	simple, raw, fields
fields	multiOptions	[]	multi: bccRecipients, body, bodyPreview, categories, ccRecipients, changeKey, conversationId, createdDateTime, ... (27 total)
filtersUI	fixedCollection	{}	groups: values
options	collection	{}	keys: attachmentsPrefix, downloadAttachments

move

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
folderId	resourceLocator	{...}	required; modes: list, url, id

reply

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
replyToSenderOnly	boolean	false
message	string	""
additionalFields	collection	{}	keys: attachments, bccRecipients, ccRecipients, internetMessageHeaders, from, importance, ...
options	collection	{}	keys: saveAsDraft

send

Parameter	Type	Default	Details
toRecipients	string	""	required
subject	string	""
bodyContent	string	""
additionalFields	collection	{}	keys: attachments, bccRecipients, categories, ccRecipients, internetMessageHeaders, from, ...

sendAndWait

Parameter	Type	Default	Details
toRecipients	string	""	required
subject	string	""	required
message	string	""	required
responseType	options	"approval"	approval, freeText, customForm
defineForm	options	"fields"	fields, json
jsonOutput	json	"[
{
"fieldLabel": "Name",
"..."
formFields	fixedCollection	{}	groups: values
formFields	fixedCollection	{}	groups: values
approvalOptions	fixedCollection	{}	groups: values
options	collection	{}	keys: limitWaitTime, appendAttribution
options	collection	{}	keys: messageButtonLabel, responseFormTitle, responseFormDescription, responseFormButtonLabel, responseFormCustomCss, limitWaitTime, ...

update

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
updateFields	collection	{}	keys: bccRecipients, categories, ccRecipients, internetMessageHeaders, folderId, importance, ...

Resource: messageAttachment

add

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
binaryPropertyName	string	"data"	required
options	collection	{}	keys: fileName

download

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
attachmentId	resourceLocator	{...}	required; modes: list, id
binaryPropertyName	string	"data"	required

get

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
attachmentId	resourceLocator	{...}	required; modes: list, id
options	collection	{}	keys: fields

getAll

Parameter	Type	Default	Details
messageId	resourceLocator	{...}	required; modes: list, id
returnAll	boolean	false
limit	number	100
options	collection	{}	keys: fields

Parameter Details

additionalFields children:

Parameter	Type	Default	Details
calendarGroup	options	[]
color	options	"lightBlue"	lightBlue, lightBrown, lightGray, lightGreen, lightOrange, lightPink, lightRed, lightTeal, ... (9 total)

filters children:

Parameter	Type	Default	Details
custom	string	""

updateFields children:

Parameter	Type	Default	Details
color	options	"lightBlue"	lightBlue, lightBrown, lightGray, lightGreen, lightOrange, lightPink, lightRed, lightTeal, ... (9 total)
isDefaultCalendar	boolean	false
name	string	""

options children:

Parameter	Type	Default	Details
attachmentsPrefix	string	"attachment_"
downloadAttachments	boolean	false

filtersUI children:

values group:

Parameter	Type	Default	Details
filterBy	options	"filters"	filters, search
search	string	""
filters	collection	{}	keys: custom, hasAttachments, readStatus, receivedAfter, receivedBefore, sender

formFields children:

values group:

Parameter	Type	Default	Details
fieldName	string	""	required
fieldLabel	string	""	required
fieldLabel	string	""	required
fieldName	string	""
fieldType	options	"text"	required; checkbox, html, date, dropdown, email, file, hiddenField, number, ... (12 total)
elementName	string	""
fieldName	string	""
placeholder	string	""
defaultValue	string	""
defaultValue	dateTime	""
defaultValue	string	""
defaultValue	string	""
fieldValue	string	""
fieldOptions	fixedCollection	{...}	required; groups: values
fieldOptions	fixedCollection	{...}	required; groups: values
fieldOptions	fixedCollection	{...}	required; groups: values
multiselect	boolean	false
limitSelection	options	"unlimited"	exact, range, unlimited
numberOfSelections	number	1
minSelections	number	0
maxSelections	number	1
html	string	"

" | | | multipleFiles | boolean | true | | | acceptFileTypes | string | "" | | | requiredField | boolean | false | |

approvalOptions children:

values group:

Parameter	Type	Default	Details
approvalType	options	"single"	single, double
approveLabel	string	"Approve"
buttonApprovalStyle	options	"primary"	primary, secondary
disapproveLabel	string	"Decline"
buttonDisapprovalStyle	options	"secondary"	primary, secondary

Example

NODE "microsoftOutlook" @microsoft AS "Microsoft Outlook" {
  resource: "calendar",
  operation: "get",
  name: {{ $json.name }},
  givenName: {{ $json.givenName }},
  displayName: {{ $json.displayName }}
}