# New Attachment Received (Instant) — Microsoft Outlook Email

> Emit new event when a new email containing one or more attachments arrives in a specified Microsoft Outlook folder.

- Key: `microsoft_outlook-new-attachment-received`
- Type: Trigger (Polling)
- Version: 0.1.22
- App: Microsoft Outlook Email (`microsoft_outlook`) — https://pipedream.com/apps/microsoft-outlook.md
- This page (HTML): https://pipedream.com/apps/microsoft-outlook/triggers/new-attachment-received
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/microsoft_outlook/sources/new-attachment-received/new-attachment-received.mjs

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `timer` | `$.interface.timer` | Yes | Graph API expires Outlook notifications in ~3 days; we request a 2.5-day expiration and auto-renew daily, See the documentation |
| `folderIds` | `string[]` | No | Specify the folder IDs or names in Outlook that you want to monitor for new emails. Leave empty to monitor all folders (excluding "Sent Items" and "Drafts"). Options are loaded from the connected account. |
| `includeLink` | `boolean` | No | Upload attachment to your File Stash and emit temporary download link to the file. See the docs to learn more about working with files in Pipedream. |
| `dir` | `dir` | No | Dir |

## Returns

Events emitted by Microsoft Outlook Email.

## Run it

**TypeScript**

```ts
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 deployed = await pd.triggers.deploy({
  id: "microsoft_outlook-new-attachment-received",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    microsoft_outlook: { authProvisionId: "apn_xxxxxxx" },
    timer: { "intervalSeconds": 900 },
    folderIds: ["Folder IDs to Monitor"],
  },
  webhookUrl: "https://example.com/webhooks/microsoft-outlook",
})

console.log(deployed.id)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/triggers/deploy \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "microsoft_outlook-new-attachment-received",
    "webhook_url": "https://example.com/webhooks/microsoft-outlook",
    "configured_props": {
      "microsoft_outlook": { "authProvisionId": "apn_xxxxxxx" },
      "timer": { "intervalSeconds": 900 },
      "folderIds": ["Folder IDs to Monitor"]
    }
  }'
```

**MCP**

MCP servers expose Microsoft Outlook Email actions as on-demand tools.

New Attachment Received (Instant) is an event source, so your application deploys it with the Connect SDK or API and then either receives each event at a webhook URL or retrieves events on demand with the trigger events API.

## Event delivery

Every event is sent to the HTTP endpoint you choose when you deploy the source. Or: no webhook required — your app or agent can fetch recent events from the [trigger events API](https://pipedream.com/docs/connect/api-reference/list-trigger-events.md) instead.

---

- App: https://pipedream.com/apps/microsoft-outlook.md · All apps: https://pipedream.com/apps