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

Downloads a specific file attachment from an email message in a microsoft outlook mailbox; the attachment must contain 'contentbytes' (binary data) and not be a link or embedded item.

Action Parameters

attachment_id
stringRequired
file_name
stringRequired
message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Lists metadata (like name, size, and type, but not `contentbytes`) for all attachments of a specified outlook email message.

Action Parameters

message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Creates a new outlook calendar event, ensuring `start datetime` is chronologically before `end datetime`.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Creates a new contact in a microsoft outlook user's contacts folder.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Creates an outlook email draft with subject, body, recipients, and an optional attachment; attachments require a name, mimetype, and content.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Creates a draft reply in the specified user's outlook mailbox to an existing message (identified by a valid `message id`), optionally including a `comment` and cc/bcc recipients.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Permanently deletes an existing contact, using its `contact id` (obtainable via 'list user contacts' or 'get contact'), from the outlook contacts of the user specified by `user id`.

Action Parameters

contact_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Deletes an existing calendar event, identified by its unique `event id`, from a specified user's microsoft outlook calendar, with an option to send cancellation notifications to attendees.

Action Parameters

event_id
stringRequired
send_notifications
booleanDefaults to True
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Retrieves a specific outlook contact by its `contact id` from the contacts of a specified `user id` (defaults to 'me' for the authenticated user).

Action Parameters

contact_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Retrieves the full details of a specific calendar event by its id from a user's outlook calendar, provided the event exists.

Action Parameters

event_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Retrieves a specific email message by its id from the specified user's outlook mailbox, provided the message id exists for that user.

Action Parameters

message_id
stringRequired
user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Retrieves the microsoft outlook profile for a specified user.

Action Parameters

user_id
stringDefaults to me

Action Response

data
object
error
successful
boolean
Retrieves free/busy schedule information for specified email addresses within a defined time window.

Action Parameters

EndTime
objectRequired
Schedules
arrayRequired
StartTime
objectRequired
availabilityViewInterval
stringDefaults to 30

Action Response

data
object
error
successful
boolean
Retrieves a user's microsoft outlook contacts, from the default or a specified contact folder.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Retrieves events from a user's outlook calendar via microsoft graph api, supporting pagination, filtering, property selection, sorting, and timezone specification.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Retrieves a list of email messages from a specified mail folder in an outlook mailbox, with options for filtering, pagination, and sorting; ensure 'user id' and 'folder' are valid, and all date/time strings are in iso 8601 format.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Sends a plain text reply to an outlook email message, identified by `message id`, allowing optional cc and bcc recipients.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Searches messages in a microsoft 365 or enterprise outlook account mailbox, supporting filters for sender, subject, attachments, pagination, and sorting by relevance or date.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Sends an email with subject, body, recipients, and an optional attachment via microsoft graph api; attachments require a non-empty file with valid name and mimetype.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Updates specified fields of an existing outlook calendar event.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Updates an existing outlook contact, identified by `contact id` for the specified `user id`, requiring at least one other field to be modified.

Action Parameters

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

Action Response

data
object
error
successful
boolean
Updates specified properties of an existing email message; `message id` must identify a valid message within the specified `user id`'s mailbox.

Action Parameters

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

Action Response

data
object
error
successful
boolean