View as Markdown
Microsoft Outlook Email icon

Microsoft Outlook Email ACTION

Find Shared Folder Email

Search for an email in a shared folder in Microsoft Outlook. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Microsoft Outlook Email account once, then configure and run Find Shared Folder Email from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "microsoft_outlook-find-shared-folder-email",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_outlook: { authProvisionId: "apn_xxxxxxx" },
    userId: "User ID",
    sharedFolderId: "Shared Folder ID",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Find Shared Folder Email inputs
Property Type Description
userId User ID string
The ID of the user to get messages for
Required Dynamic
sharedFolderId Shared Folder ID string
The ID of the shared folder to get messages for
Required Dynamic
search Search string
Search for an email in Microsoft Outlook. Can search for specific message properties such as "to:example@example.com" or "subject:example". If the property is excluded, the search targets the default propertes from, subject, and body. For example, "pizza" will search for messages with the word pizza in the subject, body, or from address, but "to:example@example.com" will only search for messages to example@example.com. Not for use with $filter or $orderby.
Optional
filter Filter string
Filters results. For example, contains(subject, 'meet for lunch?') will include messages whose subject contains ‘meet for lunch?’. See documentation for the full list of operations. Not for use with $search.
Optional
orderBy Order By string
Order results by a property. For example, receivedDateTime desc will order messages by the received date in descending order. Not for use with $search.
Optional
maxResults Max Results integer
The maximum number of results to return
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
microsoft_outlook-find-shared-folder-email
Version
0.0.19
App
Microsoft Outlook Email
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes