Outlook Email

​

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.

​

Available Actions

​

Search Own Emails

outlookemail.searchOwnEmails

Search emails in your own mailbox including subfolders Requires Confirmation: No Parameters:

• searchQuery (TEXT, Optional): Full-text search using Microsoft Graph $search parameter. Automatically ordered by relevance
  • folderId (TEXT, Optional): ID of specific folder to search in your mailbox
  • top (NUMBER, Optional): Maximum number of emails to return (default: 50, maximum: 1000)
  • includeFields (TEXT, Optional): Comma-separated list of additional fields to include in response
  • includeAttachmentDetails (BOOLEAN, Optional): Include detailed attachment information in the response
  • senderEmail (TEXT, Optional): Filter by exact sender email address. Cannot be used with search queries
  • subjectContains (TEXT, Optional): Filter emails where subject contains this text (case-insensitive). Cannot be used with search queries
  • dateFrom (TEXT, Optional): Filter emails received on or after this date (ISO 8601 format). Cannot be used with search queries
  • dateTo (TEXT, Optional): Filter emails received on or before this date (ISO 8601 format). Cannot be used with search queries
  • isRead (SELECT, Optional): Filter by read status. Cannot be used with search queries
  • isFlagged (SELECT, Optional): Filter by flagged status. Cannot be used with search queries
  • sortBy (SELECT, Optional): Custom sort order for results. Default: ‘Newest first’

Output: Returns array of emails with their details including subject, body, sender, recipients, and metadata

---

​

Draft Reply to Message

outlookemail.draftReplytoMessage

Create 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 (TEXT, Required): ID of the message to reply to
  • 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, sends the reply to the sender and all original recipients
  • outlookTimezone (TEXT, Optional): Optional Prefer header to set timezone for the reply context

Output: Returns the created draft reply

---

​

Send Email

outlookemail.sendEmail

Sends emails on the user’s behalf via the Outlook API Requires Confirmation: Yes Parameters:

• toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients
  • subject (TEXT, Optional): Subject of the email
  • body (MULTI_LINE_TEXT, Optional): The content of the email
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML

Output: Returns the sent email with ID and details

---

​

Create Draft

outlookemail.createDraft

Creates email drafts on the user’s behalf via the Outlook API with support for multiple recipients, CC, and BCC Requires Confirmation: Yes Parameters:

• toRecipients (TEXT, Optional): Comma-separated list of email addresses for primary recipients
  • ccRecipients (TEXT, Optional): Comma-separated list of email addresses for CC recipients
  • bccRecipients (TEXT, Optional): Comma-separated list of email addresses for BCC recipients
  • subject (TEXT, Optional): Subject of the email
  • body (MULTI_LINE_TEXT, Optional): The content of the email
  • isHtml (BOOLEAN, Optional): Send email as HTML format. When enabled, the body content will be interpreted as HTML

Output: Returns the created draft with ID and details

---

​

Search Shared Email Folders

outlookemail.searchSharedEmailFolders

Search emails in shared email folders from other users. Requires read access to mailbox and specific folders Requires Confirmation: No Parameters:

• folderId (TEXT, Required): ID of the shared folder to search
  • sharedFolderOwner (TEXT, Required): Email address of the user who owns the shared folder
  • senderEmail (TEXT, Optional): Filter by exact sender email address
  • subjectContains (TEXT, Optional): Filter emails where subject contains this text (case-insensitive)
  • dateFrom (TEXT, Optional): Filter emails received on or after this date (ISO 8601 format)
  • dateTo (TEXT, Optional): Filter emails received on or before this date (ISO 8601 format)
  • isRead (SELECT, Optional): Filter by read status
  • sortBy (SELECT, Optional): Sort order for results. Default: ‘Newest first’
  • top (NUMBER, Optional): Maximum number of emails to return per page
  • includeFields (TEXT, Optional): Comma-separated list of additional fields to include in response
  • includeAttachmentDetails (BOOLEAN, Optional): Include detailed attachment information in the response

Output: Returns array of emails from shared folders

---

​

List Contacts

outlookemail.listContacts

List contacts from your default Contacts or a specific contact folder Requires Confirmation: No Parameters:

• contactFolderId (TEXT, Optional): When provided, lists contacts from this contact folder
  • top (NUMBER, Optional): Maximum number of contacts to return (default: 50, max: 999)
  • orderBy (SELECT, Optional): Sort contacts by a specific field

Output: Returns array of contacts with their details

---

​

Get Contact

outlookemail.getContact

Find and retrieve a specific contact by name, company, or contact ID Requires Confirmation: No Parameters:

• searchName (TEXT, Optional): Search for contacts by name (supports partial matches)
  • contactId (TEXT, Optional): Exact contact ID for precise lookup
  • companyName (TEXT, Optional): Filter by company name to help narrow down results
  • maxResults (NUMBER, Optional): Maximum number of contacts to return when searching by name

Output: Returns array of contacts matching the search criteria

---

​

Create Contact

outlookemail.createContact

Create a new contact in your Outlook address book or a specific contact folder Requires Confirmation: Yes Parameters:

• contactFolderId (TEXT, Optional): Optional. Create the contact inside a specific contact folder
  • givenName (TEXT, Optional): First name of the contact
  • surname (TEXT, Optional): Last name of the contact
  • displayName (TEXT, Optional): Full display name for the contact
  • emailAddresses (TEXT, Required): Comma-separated list of email addresses for the contact
  • businessPhones (TEXT, Optional): Comma-separated list of business phone numbers
  • homePhones (TEXT, Optional): Comma-separated list of home phone numbers
  • mobilePhone (TEXT, Optional): Mobile phone number
  • companyName (TEXT, Optional): Company or organization
  • jobTitle (TEXT, Optional): Contact’s job title
  • department (TEXT, Optional): Department or team
  • 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
  • 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 created contact with ID and details

---

​

List Contact Folders

outlookemail.listContactFolders

List all contact folders (default Contacts and subfolders) 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

Output: Returns array of contact folders with their details

---

​

List Folders

outlookemail.listFolders

Lists all mail folders and subfolders in the user’s mailbox and shared folders from other users with their IDs and hierarchy Requires Confirmation: No Parameters:

• includeSubfolders (BOOLEAN, Optional): Include all subfolders in the hierarchy (default: true)
  • includeHidden (BOOLEAN, Optional): Include hidden folders like Clutter
  • sortByPath (BOOLEAN, Optional): Sort folders alphabetically by their full path
  • filterType (SELECT, Optional): Filter folders by type
  • sharedFolderUsers (TEXT, Optional): Comma-separated list of email addresses of users who have granted you access to their mailbox

Output: Returns array of folders with their hierarchy and details

​

Triggers

---

​

New Email

outlookemail.newEmail

Triggers when a new email is received Requires Confirmation: No Parameters:

• includeAttachments (BOOLEAN, Optional): When enabled, includes attachment details in the trigger output

Output: Returns the operation result

---

​

New Email Matching Search

outlookemail.newEmailMatchingSearch

Triggers when new emails matching the specified search query are received Requires Confirmation: No Parameters:

• includeAttachments (BOOLEAN, Optional): When enabled, includes attachment details in the trigger output
  • searchQuery (TEXT, Required): Microsoft Graph search query to filter emails

Output: Returns the operation result

---

​

New Email in Shared Inbox

outlookemail.newEmailinSharedInbox

Triggers when new emails are received in specified shared inboxes Requires Confirmation: No Parameters:

• sharedFolderOwners (TEXT, Required): Comma-separated list of user emails whose shared inboxes to monitor
  • folderId (TEXT, Optional): Folder to monitor within each shared inbox (default: inbox)
  • includeAttachments (BOOLEAN, Optional): When enabled, includes attachment details in the trigger output

Output: Returns the operation result

---

​

Common Use Cases

​

Best Practices

​

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

​

Support

For additional help with the Outlook Email integration, contact support@langdock.com