Outlook

Learn how to use Outlook with Composio

Overview

SLUG

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
bearer_token
string

Tools

SLUG: OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_CALENDAR_CREATE_EVENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_CREATE_CONTACT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_CREATE_DRAFT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_GET_CONTACT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_GET_EVENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_GET_PROFILE

Retrieves the microsoft outlook profile for a specified user.

Action Parameters

user_id
stringDefaults to me

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_LIST_EVENTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_LIST_MESSAGES

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_REPLY_EMAIL

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_SEND_EMAIL

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_UPDATE_EMAIL

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_LIST_OUTLOOK_ATTACHMENTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_CREATE_DRAFT_REPLY

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_DELETE_CONTACT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_DELETE_EVENT

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_GET_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_GET_SCHEDULE

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
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_LIST_CONTACTS

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
objectRequired
error
string
successful
booleanRequired

SLUG: OUTLOOK_OUTLOOK_SEARCH_MESSAGES

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
objectRequired
error
string
successful
booleanRequired