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.

Authentication: OAuth Category: Microsoft 365 Availability: All workspace plans

---

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

• Data Management: Manage and organize your Outlook Email data

• Automation: Automate workflows with Outlook Email

• Reporting: Generate insights and reports

• Integration: Connect Outlook Email with other tools

---

Best Practices

1

Getting Started

• Enable the Outlook Email integration in your workspace settings

• Authenticate using OAuth

• Test the connection with a simple read operation

• Explore available actions for your use case

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

---

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 [email protected]

---