Outlook

Learn how to use Outlook with Composio

Overview

Enum

OUTLOOK

Description

Outlook is Microsoft’s email and calendaring platform integrating contacts, tasks, and scheduling, enabling users to manage communications and events in a unified workspace

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to Calendars.Read,Calendars.ReadWrite,Calendars.ReadWrite.Shared,Contacts.ReadWrite,Mail.Read,Mail.ReadWrite,Mail.Send,offline_access,User.Read

Actions

Get a specific contact by id from outlook using microsoft graph api.

Action Parameters

user_id
stringDefaults to me
contact_id
stringRequired

Action Response

data
object
successful
boolean
error

Action to list outlook contacts using microsoft graph.

Action Parameters

user_id
stringDefaults to me
contact_folder_id
string
top
integerDefaults to 10
filter
string
select
array
orderby
array

Action Response

data
object
successful
boolean
error

Retrieve an email message by its id using the microsoft graph api.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired

Action Response

data
object
successful
boolean
error

Get a specific calendar event by id from outlook using microsoft graph api.

Action Parameters

user_id
stringDefaults to me
event_id
stringRequired

Action Response

data
object
successful
boolean
error

Action to search outlook messages using the microsoft search api for work/school accounts. note: this tool only supports microsoft 365/enterprise accounts and does not support @hotmail.com or @outlook.com addresses.

Action Parameters

query
string
fromEmail
string
subject
string
hasAttachments
boolean
from_index
integer
size
integerDefaults to 25
enable_top_results
boolean

Action Response

data
object
successful
boolean
error

Create a draft email using microsoft graph api for outlook.

Action Parameters

subject
stringRequired
body
stringRequired
to_recipients
arrayRequired
cc_recipients
array
bcc_recipients
array
is_html
boolean
attachment
object

Action Response

data
object
successful
boolean
error

List messages in the user’s mailbox using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
folder
stringDefaults to inbox
top
integerDefaults to 10
skip
integer
is_read
boolean
importance
string
subject
string
received_date_time_gt
string
subject_startswith
string
subject_endswith
string
subject_contains
string
received_date_time_ge
string
received_date_time_lt
string
received_date_time_le
string
from_address
string
has_attachments
boolean
body_preview_contains
string
sent_date_time_gt
string
sent_date_time_lt
string
categories
array
select
array
orderby
array

Action Response

data
object
successful
boolean
error

Reply to an email using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
comment
stringRequired
cc_emails
array
bcc_emails
array

Action Response

data
object
successful
boolean
error

List events in the user’s calendar using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
top
integerDefaults to 10
skip
integer
filter
string
select
array
orderby
array
timezone
stringDefaults to UTC

Action Response

data
object
successful
boolean
error

Get the free/busy schedule of users and resources for a specific time period. this action requires a minimum of calendars.readbasic permission and can retrieve availability information for up to 20 users or resources at once, for a time period of up to 62 days.

Action Parameters

Schedules
arrayRequired
StartTime
objectRequired
EndTime
objectRequired
availabilityViewInterval
stringDefaults to 30

Action Response

data
object
successful
boolean
error

Update an existing email message.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
subject
string
body
object
importance
stringDefaults to normal
cc_recipients
array
bcc_recipients
array
to_recipients
array

Action Response

data
object
successful
boolean
error

Create a new contact in the user’s outlook contacts using microsoft graph api.

Action Parameters

user_id
stringDefaults to me
displayName
string
givenName
string
surname
string
emailAddresses
array
businessPhones
array
mobilePhone
string
homePhone
string
companyName
string
jobTitle
string
department
string
officeLocation
string
birthday
string
notes
string
categories
array

Action Response

data
object
successful
boolean
error

Delete a calendar event using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
event_id
stringRequired
send_notifications
booleanDefaults to True

Action Response

data
object
successful
boolean
error

Retrieve a list of attachments for a specific outlook email message using microsoft graph api, omitting any base64 content bytes.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired

Action Response

data
object
successful
boolean
error

Send an email using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
subject
stringRequired
body
stringRequired
to_email
stringRequired
to_name
string
cc_emails
array
bcc_emails
array
is_html
boolean
save_to_sent_items
booleanDefaults to True
attachment
object

Action Response

data
object
successful
boolean
error

Create an event in the user’s calendar via microsoft graph api. this tool expects a flattened ‘attendees info’ from the user/llm, then transforms them into the nested shape required by microsoft graph.

Action Parameters

user_id
stringDefaults to me
subject
stringRequired
body
stringRequired
is_html
boolean
start_datetime
stringRequired
end_datetime
stringRequired
time_zone
stringRequired
attendees_info
array
location
string
show_as
stringDefaults to busy
categories
array

Action Response

data
object
successful
boolean
error

Update an existing contact for the user in outlook contacts.

Action Parameters

user_id
stringDefaults to me
contact_id
stringRequired
displayName
string
givenName
string
surname
string
emailAddresses
array
businessPhones
array
mobilePhone
string
homePhones
array
companyName
string
jobTitle
string
department
string
officeLocation
string
birthday
string
notes
string
categories
array

Action Response

data
object
successful
boolean
error

Delete a contact from the user’s outlook contacts using microsoft graph api. the contact id can be obtained from outlook get contacts or outlook get contact actions.

Action Parameters

user_id
stringDefaults to me
contact_id
stringRequired

Action Response

data
object
successful
boolean
error

Get the profile of a user in outlook using microsoft graph api.

Action Parameters

user_id
stringDefaults to me

Action Response

data
object
successful
boolean
error

Create a draft reply to an email using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
comment
string
cc_emails
array
bcc_emails
array

Action Response

data
object
successful
boolean
error

Download an attachment from an outlook mail.

Action Parameters

user_id
stringDefaults to me
message_id
stringRequired
attachment_id
stringRequired
file_name
stringRequired

Action Response

data
object
successful
boolean
error

Update an event in the user’s calendar using microsoft graph api for outlook.

Action Parameters

user_id
stringDefaults to me
event_id
stringRequired
subject
string
body
object
start_datetime
string
end_datetime
string
time_zone
stringDefaults to UTC
attendees
array
location
object
show_as
stringDefaults to busy
categories
array

Action Response

data
object
successful
boolean
error