# New Email Event (Instant) — Microsoft Outlook Email

> Emit new event when an email is received in specified folders.

- Key: `microsoft_outlook-new-email`
- 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-email
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/microsoft_outlook/sources/new-email/new-email.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. |

## 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-email",
  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-email",
    "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 Email Event (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