Outlook

🚀 Quickstart

Connect to Outlook with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Outlook. Nango doesn’t provide a test OAuth app for Outlook yet. You’ll need to set up your own by following the setup guide linked below. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.

Authorize Outlook

Go to Connections -> Add Test Connection -> Authorize, then log in to Outlook. Later, you’ll let your users do the same directly from your app.

Call the Outlook API

Let’s make your first request to the Outlook (Microsoft Graph) API (fetch the profile of the currently signed-in user). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1.0/me" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/v1.0/me',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Outlook Integration Guides

Nango maintained guides for common use cases.

How to register your own Outlook OAuth app
Register an OAuth app with Outlook and obtain credentials to connect it to Nango

Official docs: Microsoft Graph API documentation

🧩 Pre-built syncs & actions for Outlook

Enable them in your dashboard. Extend and customize to fit your needs.

Calendar

Function name	Description	Type	Source code
`delete-event`	Delete an event from a calendar.	Action	🔗 Github

Calendars

Function name	Description	Type	Source code
`create-calendar`	Create a secondary calendar in the mailbox.	Action	🔗 Github
`delete-calendar`	Delete a secondary calendar.	Action	🔗 Github
`get-calendar`	Retrieve a calendar by ID.	Action	🔗 Github
`list-calendars`	List calendars in the mailbox.	Action	🔗 Github
`update-calendar`	Update calendar properties.	Action	🔗 Github

Events

Function name	Description	Type	Source code
`add-event-attachment`	Attach a small file (under 3 MB) to an Outlook event.	Action	🔗 Github
`cancel-event`	Cancel a meeting and send the cancellation notice to attendees	Action	🔗 Github
`create-event`	Create an event on a calendar.	Action	🔗 Github
`get-event`	Retrieve an event by ID from the user’s calendar	Action	🔗 Github
`list-event-attachments`	List attachments on an event.	Action	🔗 Github
`update-event`	Update event details in Outlook calendar.	Action	🔗 Github

Mail

Function name	Description	Type	Source code
`create-mail-folder`	Create a child mail folder in Outlook.	Action	🔗 Github
`list-mail-folders`	List top-level mail folders from the mailbox	Action	🔗 Github
`send-mail`	Send a new email message immediately	Action	🔗 Github

Mail Folders

Function name	Description	Type	Source code
`list-mail-folder-children`	List child folders under a mail folder	Action	🔗 Github

Messages

Function name	Description	Type	Source code
`add-message-attachment`	Attach a file to a draft message. Note: 3 MB simple upload limit applies.	Action	🔗 Github
`create-draft-message`	Create a draft email message	Action	🔗 Github
`delete-message`	Delete a message from the mailbox	Action	🔗 Github
`download-message-attachment`	Download the content of a file attachment on a message.	Action	🔗 Github
`get-message`	Retrieve a message by ID.	Action	🔗 Github
`list-message-attachments`	List attachments on a message.	Action	🔗 Github
`list-messages`	List messages from a mail folder.	Action	🔗 Github
`move-message`	Move a message to another mail folder.	Action	🔗 Github
`reply-all-to-message`	Reply to all recipients on a message	Action	🔗 Github
`reply-to-message`	Reply to a message sender.	Action	🔗 Github
`send-draft-message`	Send an existing draft message.	Action	🔗 Github
`update-message`	Update a draft or mutable message fields.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`copy-message`	Copy a message to another mail folder.	Action	🔗 Github
`list-calendar-events`	List events from a calendar or date window.	Action	🔗 Github
`calendars`	Sync mailbox calendars and basic calendar metadata	Sync	🔗 Github
`events`	Sync events in a bounded calendar view with delta tokens.	Sync	🔗 Github
`mail-folders`	Sync the mail folder hierarchy	Sync	🔗 Github
`messages`	Sync folder-scoped messages with delta tokens	Sync	🔗 Github

Overview

700+ APIs & Integrations

🚀 Quickstart

📚 Outlook Integration Guides

🧩 Pre-built syncs & actions for Outlook

Calendar

Calendars

Events

Mail

Mail Folders

Messages

Others

Overview

700+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Outlook Integration Guides

​🧩 Pre-built syncs & actions for Outlook

​Calendar

​Calendars

​Events

​Mail

​Mail Folders

​Messages

​Others

🚀 Quickstart

📚 Outlook Integration Guides

🧩 Pre-built syncs & actions for Outlook

Calendar

Calendars

Events

Mail

Mail Folders

Messages

Others