Skip to main content

​
Overview

Microsoft’s email service for personal and business communication. Through Langdock’s integration, you can access and manage Outlook Email directly from your conversations.
Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

​
Available Actions

​
Search own emails

outlook_email.search_own_emails
Searches emails in your own mailbox including subfolders. Requires Confirmation: No Parameters:
  • searchQuery (TEXT, Optional): Full-text search query using KQL syntax. Supported properties: from:user@example.com, subject:keyword, hasAttachments:true, attachment:pdf (filter by attachment filename/extension), body:keyword, importance:high. Combine with AND/OR (e.g. hasAttachments:true AND attachment:pdf). Cannot be combine…
  • folderId (ID, Optional): ID of a specific folder to search in your mailbox. Leave empty to search all folders (default behavior).
  • limit (NUMBER, Optional): Maximum number of emails to return. Default: 10.
  • includeDetails (BOOLEAN, Optional): Include timestamps, read status, importance, and flags. Enabled by default. Set to false to return only essential fields.
  • includeAttachmentDetails (BOOLEAN, Optional): Include detailed attachment information in the response (name, size, type, etc.)
  • senderEmail (TEXT, Optional): Filter by exact sender email address (e.g., john@company.com). Cannot be combined with search query.
  • subjectContains (TEXT, Optional): Filter emails where subject contains this text (case-insensitive). Cannot be combined with search query.
  • dateFrom (TEXT, Optional): Filter emails received on or after this date. Use ISO 8601 format (e.g., 2024-01-01T00:00:00Z). Cannot be combined with search query.
  • dateTo (TEXT, Optional): Filter emails received on or before this date. Use ISO 8601 format (e.g., 2024-01-31T23:59:59Z). Cannot be combined with search query.
  • isRead (BOOLEAN, Optional): Filter by read status. Set to true for read emails only, false for unread only. Leave empty to include all.
  • isFlagged (SELECT, Optional): Filter by flagged status. Cannot be used with search queries. Leave unset to include all emails.
  • sortBy (SELECT, Optional): Sort order for results. Default: newest first (receivedDateTime desc).
Output: Returns the operation result

​
Send email

outlook_email.send_email
Sends an email to the specified recipients immediately Requires Confirmation: Yes Parameters:
  • toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients (e.g., john@example.com, jane@example.com)
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients (e.g., manager@example.com, team@example.com)
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients (e.g., audit@example.com, backup@example.com)
  • subject (TEXT, Optional): Subject line for the email. Leave empty for no subject.
  • body (MULTI_LINE_TEXT, Optional): Content of the email. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML. Default is plain text.
  • files (FILE, Optional): Files to attach to the email. Multiple files can be added.
Output: Returns the operation result

​
Create draft

outlook_email.create_draft
Creates an email draft in the Drafts folder for later review and sending Requires Confirmation: Yes Parameters:
  • toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients (e.g., john@example.com, jane@example.com)
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients (e.g., manager@example.com, team@example.com)
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients (e.g., audit@example.com, backup@example.com)
  • subject (TEXT, Optional): Subject line for the email. Leave empty for no subject.
  • body (MULTI_LINE_TEXT, Optional): Content of the email. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML. Default is plain text.
  • files (FILE, Optional): Files to attach to the draft email. Multiple files can be added.
Output: Returns the operation result

​
Send draft

outlook_email.send_draft
Sends an existing draft email by ID Requires Confirmation: Yes Parameters:
  • draftId (ID, Required): ID of the draft to send. Use ‘List drafts’ action to find available drafts.
Output: Returns the operation result

​
Search shared email folders

outlook_email.search_shared_email_folders
Searches emails in shared email folders from other users. Requires read access to mailbox and specific folders. Requires Confirmation: No Parameters:
  • folderId (ID, Optional): ID of a specific shared folder to search. Leave empty to search shared inbox (default behavior).
  • sharedFolderOwner (TEXT, Required): Email address of the user who owns the shared folder. Required. You must have both Mail.Read.Shared permission AND explicit folder sharing permission from this user.
  • senderEmail (TEXT, Optional): Filter by exact sender email address (e.g., john@company.com).
  • subjectContains (TEXT, Optional): Filter emails where subject contains this text (case-insensitive).
  • dateFrom (TEXT, Optional): Filter emails received on or after this date. Use ISO 8601 format (e.g., 2024-01-01T00:00:00Z).
  • dateTo (TEXT, Optional): Filter emails received on or before this date. Use ISO 8601 format (e.g., 2024-01-31T23:59:59Z).
  • isRead (BOOLEAN, Optional): Filter by read status. Set to true for read emails only, false for unread only. Leave empty to include all.
  • sortBy (SELECT, Optional): Sort order for results. Default: newest first (receivedDateTime desc).
  • limit (NUMBER, Optional): Maximum number of emails to return. Default: 10.
  • includeFields (TEXT, Optional): Comma-separated list of additional fields to include in response. Default fields: id, subject, bodyPreview, body, from, toRecipients, receivedDateTime, hasAttachments, isRead, webLink
  • includeAttachmentDetails (BOOLEAN, Optional): Include detailed attachment information in the response (name, size, type, etc.)
Output: Returns the operation result

​
Update draft

outlook_email.update_draft
Updates an existing draft email by ID. Modify its subject, body, recipients, or attachments. Requires Confirmation: Yes Parameters:
  • draftId (ID, Required): ID of the draft to update. Use ‘List drafts’ action to find available drafts.
  • newSubject (TEXT, Optional): New subject line for the draft. Leave empty to keep the current subject.
  • newBody (MULTI_LINE_TEXT, Optional): New content for the draft. Leave empty to keep the current body. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): When enabled, the new body content will be interpreted as HTML. Default is plain text.
  • newToRecipients (TEXT, Optional): Replace the To recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • newCcRecipients (TEXT, Optional): Replace the CC recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • newBccRecipients (TEXT, Optional): Replace the BCC recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • files (FILE, Optional): Add new attachments to the draft. Note: This adds to existing attachments, it does not replace them.
Output: Returns the operation result

​
List contacts

outlook_email.list_contacts
Lists contacts from your default Contacts or a specific contact folder. If listing from a contact folder, first use ‘List contact folders’ to get the folder ID. Requires Confirmation: No Parameters:
  • contactFolderId (ID, Optional): When provided, lists contacts from this contact folder (use ‘List contact folders’ to fetch IDs). Leave empty to list from the default Contacts folder.
  • limit (NUMBER, Optional): Maximum number of contacts to return. Default: 20.
  • orderBy (SELECT, Optional): Sort contacts by a specific field. Default is display name A-Z.
Output: Returns the operation result

​
Get contact

outlook_email.get_contact
Finds and retrieves a specific contact by name, company, or contact ID. Requires Confirmation: No Parameters:
  • searchName (TEXT, Optional): Search for contacts by name (supports partial matches, e.g., ‘John’, ‘John Smith’, ‘Smith’)
  • contactId (ID, Optional): Direct lookup by contact ID. Get this ID from the List Contacts action.
  • companyName (TEXT, Optional): Filter by company name to help narrow down results when searching by name
  • maxResults (NUMBER, Optional): Maximum number of contacts to return when searching by name (default: 10, max: 50)
Output: Returns the operation result

​
Draft reply to message

outlook_email.draft_reply_to_message
Creates a draft reply to an existing email. Use the toggle to choose Reply (sender only) or Reply all (sender and all recipients). Requires Confirmation: Yes Parameters:
  • messageId (ID, Required): ID of the message to reply to (use search/list actions to get it)
  • body (MULTI_LINE_TEXT, Optional): Content of the reply. If HTML is enabled, interpreted as HTML; otherwise sent as a plain text comment.
  • isHtml (BOOLEAN, Optional): When enabled, sends the reply body as HTML using message.body; otherwise sends as a simple text comment.
  • replyAll (BOOLEAN, Optional): When enabled, replies to sender and all original recipients. Defaults to false (reply to sender only).
  • outlookTimezone (TEXT, Optional): Optional Prefer header to set timezone for the reply context (e.g., ‘Europe/Berlin’).
  • files (FILE, Optional): Files to attach to the reply. Multiple files can be added.
Output: Returns the operation result

​
Create contact

outlook_email.create_contact
Creates a new contact in your Outlook address book or a specific contact folder. Requires Confirmation: Yes Parameters:
  • emailAddresses (TEXT, Required): Comma-separated list of email addresses for the contact (e.g., pavelb@contoso.com, pavel.personal@example.com)
  • givenName (TEXT, Optional): First name of the contact (e.g., Pavel).
  • surname (TEXT, Optional): Last name of the contact (e.g., Bansky).
  • displayName (TEXT, Optional): Full display name for the contact. If not set, it will be derived from givenName and surname.
  • businessPhones (TEXT, Optional): Comma-separated list of business phone numbers
  • mobilePhone (TEXT, Optional): Mobile phone number (e.g., +1 555 123 4567).
  • companyName (TEXT, Optional): Company or organization name (e.g., Contoso).
  • jobTitle (TEXT, Optional): Contact’s job title (e.g., Sales Manager).
  • department (TEXT, Optional): Department or team (e.g., Sales, Engineering).
  • businessAddressStreet (TEXT, Optional): Street of the business address
  • businessAddressCity (TEXT, Optional): City of the business address
  • businessAddressState (TEXT, Optional): State/Province of the business address
  • businessAddressPostalCode (TEXT, Optional): Postal/ZIP code of the business address
  • businessAddressCountryOrRegion (TEXT, Optional): Country/Region of the business address
  • contactFolderId (ID, Optional): Optional. Create the contact inside a specific contact folder. Leave empty to create in the root Contacts folder.
  • homeAddressStreet (TEXT, Optional): Street of the home address
  • homeAddressCity (TEXT, Optional): City of the home address
  • homeAddressState (TEXT, Optional): State/Province of the home address
  • homeAddressPostalCode (TEXT, Optional): Postal/ZIP code of the home address
  • homeAddressCountryOrRegion (TEXT, Optional): Country/Region of the home address
  • categories (TEXT, Optional): Comma-separated list of categories to assign to the contact
Output: Returns the operation result

​
Get email

outlook_email.get_email
Gets a single email by ID and downloads all attachments. Requires Confirmation: No Parameters:
  • messageId (ID, Required): ID of the email message to fetch (use search/list/triggers to get it).
  • sharedFolderOwner (TEXT, Optional): Optional. Email address of the user if fetching from a shared mailbox you have access to (requires Mail.Read.Shared and explicit folder sharing).
  • returnHtml (BOOLEAN, Optional): Return original HTML content instead of plain text. Default is plain text (disabled).
Output: Returns the operation result

​
Forward email

outlook_email.forward_email
Forwards an existing email message to one or more recipients with optional comment Requires Confirmation: Yes Parameters:
  • messageId (ID, Required): ID of the email message to forward (use search/list actions to get it)
  • toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients (e.g., john@example.com, jane@example.com)
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients (e.g., manager@example.com, team@example.com)
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients (e.g., audit@example.com, backup@example.com)
  • comment (MULTI_LINE_TEXT, Optional): Optional message to include above the forwarded content.
  • outlookTimezone (TEXT, Optional): Optional Prefer header to set timezone for the forwarded message (e.g., ‘Europe/Berlin’)
Output: Returns the operation result

​
Send reply

outlook_email.send_reply
Sends a reply to an existing email. Use the toggle to choose Reply (sender only) or Reply all (sender and all recipients). Requires Confirmation: Yes Parameters:
  • messageId (ID, Required): ID of the message to reply to (use search/list actions to get it)
  • replyBody (MULTI_LINE_TEXT, Optional): Content of the reply. If HTML is enabled, interpreted as HTML; otherwise sent as a plain text comment.
  • isHtml (BOOLEAN, Optional): When enabled, sends the reply body as HTML using message.body; otherwise sends as a simple text comment.
  • outlookTimezone (TEXT, Optional): Optional Prefer header to set timezone for the reply context (e.g., ‘Europe/Berlin’).
  • replyAll (BOOLEAN, Optional): When enabled, replies to sender and all original recipients. Defaults to false (reply to sender only).
  • files (FILE, Optional): Files to attach to the reply. Multiple files can be added.
Output: Returns the operation result

​
List contact folders

outlook_email.list_contact_folders
Lists all contact folders (default Contacts and subfolders). Use this to retrieve the contact folder ID before listing contacts inside a folder. Requires Confirmation: No Parameters:
  • includeSubfolders (BOOLEAN, Optional): Include all nested child contact folders (default: true)
  • sortByPath (BOOLEAN, Optional): Sort folders alphabetically by their full path. Default is unsorted (hierarchy order).
  • limit (NUMBER, Optional): Maximum number of folders to return. Leave empty for all folders.
Output: Returns the operation result

​
Move email to folder

outlook_email.move_email_to_folder
Moves an email to a different folder. Accepts folder IDs or well-known names (inbox, drafts, sentitems, deleteditems, junkemail, outbox, archive, conversationhistory, scheduled, clutter). Use list_folders to get folder IDs. Requires Confirmation: Yes Parameters:
  • messageId (ID, Required): ID of the email message to move
  • folderId (ID, Required): Destination folder ID or well-known name (inbox, drafts, sentitems, deleteditems, junkemail, outbox, archive, conversationhistory, scheduled, clutter). Use list_folders to get folder IDs for custom folders.
  • sharedFolderOwner (TEXT, Optional): Optional. Email address of the user if moving emails in a shared mailbox you have access to.
Output: Returns the operation result

​
List folders

outlook_email.list_folders
Lists mail folders in the user’s mailbox. Returns both well-known folders (inbox, drafts, sentitems, deleteditems, junkemail, outbox, archive, conversationhistory, scheduled, clutter) and custom folders. Use folder type filter to show only well-known or custom folders. Requires Confirmation: No Parameters:
  • searchQuery (TEXT, Optional): Filter folders by name (case-insensitive partial match). Returns only folders whose name contains this text.
  • includeSubfolders (BOOLEAN, Optional): Include all subfolders in the hierarchy (default: true).
  • includeHidden (BOOLEAN, Optional): Include hidden system folders like Clutter. Default is false.
  • sortByPath (BOOLEAN, Optional): Sort folders alphabetically by their full path. Default is unsorted (hierarchy order).
  • filterType (SELECT, Optional): Filter folders by type or content. ‘Well-known’ and ‘Custom’ filter by folder type; ‘Non-empty’ and ‘Has unread’ filter by content. Leave empty to show all folders.
  • sharedFolderUsers (TEXT, Optional): Comma-separated list of email addresses of users who have granted you access to their mailbox. When provided, only shared folders are returned (your own folders are excluded). IMPORTANT: Two levels of permission are required: 1) General mailbox read access, and 2) Individual folder sharing permis…
  • limit (NUMBER, Optional): Maximum number of folders to return. Default: 10 when searching/filtering, 50 when listing all.
Output: Returns the operation result

​
Send email from shared mailbox or other user

outlook_email.send_email_as_other_user
Sends emails from a shared mailbox (e.g., support@company.com) or another user’s mailbox with delegated access. Requires ‘Send As’ or ‘Send on Behalf’ permission for user mailboxes, or membership in the shared mailbox. Requires Confirmation: Yes Parameters:
  • fromUserEmail (TEXT, Required): Email address of the shared mailbox (e.g., support@company.com) or another user’s mailbox to send from. Requires ‘Send As’ or ‘Send on Behalf’ permission for user mailboxes, or membership in the shared mailbox.
  • toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients (e.g., john@example.com, jane@example.com)
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients (e.g., manager@example.com, team@example.com)
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients (e.g., audit@example.com, backup@example.com)
  • subject (TEXT, Optional): Subject line for the email. Leave empty for no subject.
  • body (MULTI_LINE_TEXT, Optional): Content of the email. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML. Default is plain text.
  • files (FILE, Optional): Files to attach to the email. Multiple files can be added.
Output: Returns the operation result

​
List drafts

outlook_email.list_drafts
Lists all draft emails in the Drafts folder Requires Confirmation: No Parameters:
  • limit (NUMBER, Optional): Maximum number of drafts to return. Default: 50.
Output: Returns the operation result

​
Create draft in shared mailbox

outlook_email.create_draft_in_shared_mailbox
Creates an email draft in a shared mailbox (e.g., support@company.com) or another user’s mailbox for later review and sending. The draft appears in the target mailbox’s Drafts folder. Requires membership in the shared mailbox or delegated access to the user’s mailbox. Requires Confirmation: Yes Parameters:
  • mailboxEmail (TEXT, Required): Email address of the shared mailbox containing the draft (e.g., support@company.com). Requires membership in the shared mailbox or delegated access.
  • toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients (e.g., john@example.com, jane@example.com)
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients (e.g., manager@example.com, team@example.com)
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients (e.g., audit@example.com, backup@example.com)
  • subject (TEXT, Optional): Subject line for the email. Leave empty for no subject.
  • body (MULTI_LINE_TEXT, Optional): Content of the email. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML. Default is plain text.
  • files (FILE, Optional): Files to attach to the draft email. Multiple files can be added.
Output: Returns the operation result

​
Update draft in shared mailbox

outlook_email.update_draft_in_shared_mailbox
Updates an existing draft email in a shared mailbox by ID. Modify its subject, body, recipients, or attachments. The draft must already exist in the target mailbox’s Drafts folder. Requires Confirmation: Yes Parameters:
  • mailboxEmail (TEXT, Required): Email address of the shared mailbox containing the draft (e.g., support@company.com). Requires membership in the shared mailbox or delegated access.
  • draftId (ID, Required): ID of the draft to update in the shared mailbox.
  • newSubject (TEXT, Optional): New subject line for the draft. Leave empty to keep the current subject.
  • newBody (MULTI_LINE_TEXT, Optional): New content for the draft. Leave empty to keep the current body. Plain text by default, or HTML if HTML format is enabled.
  • isHtml (BOOLEAN, Optional): When enabled, the new body content will be interpreted as HTML. Default is plain text.
  • newToRecipients (TEXT, Optional): Replace the To recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • newCcRecipients (TEXT, Optional): Replace the CC recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • newBccRecipients (TEXT, Optional): Replace the BCC recipients with this comma-separated list of email addresses. Leave empty to keep current recipients.
  • files (FILE, Optional): Add new attachments to the draft. Note: This adds to existing attachments, it does not replace them.
Output: Returns the operation result

​
Send draft from shared mailbox

outlook_email.send_draft_from_shared_mailbox
Sends an existing draft email from a shared mailbox by ID. The draft must already exist in the target mailbox’s Drafts folder. Requires Confirmation: Yes Parameters:
  • mailboxEmail (TEXT, Required): Email address of the shared mailbox containing the draft to send (e.g., support@company.com). Requires membership in the shared mailbox or delegated access.
  • draftId (ID, Required): ID of the draft to send from the shared mailbox.
Output: Returns the operation result

​
List drafts in shared mailbox

outlook_email.list_drafts_in_shared_mailbox
Lists draft emails from a shared mailbox’s Drafts folder. Returns draft subjects, recipients, creation dates, and attachment status. Use for browsing drafts in a shared mailbox before updating or sending them. Requires Confirmation: No Parameters:
  • mailboxEmail (TEXT, Required): Email address of the shared mailbox to list drafts from (e.g., support@company.com). Requires membership in the shared mailbox or delegated access.
  • limit (NUMBER, Optional): Maximum number of drafts to return. Default: 50.
Output: Returns the operation result

​
Triggers

​
New email

outlook_email.new_email
Triggers when a new email is received Parameters: None Output: Returns the operation result
outlook_email.new_email_matching_search
Triggers when new emails matching the specified search query are received Parameters: Output: Returns the operation result

​
New email in shared inbox

outlook_email.new_shared_email
Triggers when new emails are received in specified shared inboxes (users you have Mail.Read.Shared access to). Parameters:
  • sharedFolderOwners (TEXT, Required): Comma-separated list of user emails whose shared inboxes to monitor (e.g., shared1@company.com, shared2@company.com). Requires Mail.Read.Shared and delegated access to those mailboxes/folders.
  • folderId (TEXT, Optional): Folder to monitor within each shared inbox (default: inbox). You can use well-known names like ‘inbox’ or a folder ID from List folders.
Output: Returns the operation result

​
New email in specific folder

outlook_email.new_email_in_folder
Triggers when emails appear in a specific folder (either newly received or moved to it) Parameters:
  • folderId (TEXT, Required): ID of the folder to monitor. You can use well-known folder names like inbox, archive, deleteditems, drafts, sentitems, or find the folder ID in the Outlook web URL when viewing the folder.
  • includeAttachments (BOOLEAN, Optional): Download and include email attachments in the trigger output (name, size, type, and file content). Default is true.
Output: Returns the operation result

​
New email in shared mailbox folder

outlook_email.new_shared_email_in_folder
Triggers when emails appear in a specific folder of a shared mailbox (either newly received or moved to it). Requires Mail.Read.Shared permission and folder access. Parameters:
  • sharedMailboxOwner (TEXT, Required): Email address of the shared mailbox to monitor (e.g., support@company.com). You must have Mail.Read.Shared permission and access to this mailbox.
  • folderId (TEXT, Required): ID of the folder to monitor within the shared mailbox. You can use well-known folder names like inbox, archive, deleteditems, drafts, sentitems, or a folder ID from List folders.
  • includeAttachments (BOOLEAN, Optional): Download and include email attachments in the trigger output (name, size, type, and file content). Default is true.
Output: Returns the operation result