Outlook

Integrate your application with the Outlook API

🚀 Quickstart

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

1. 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.

2. 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.

3. 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

   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>"
   

   Or fetch credentials with the Node SDK or API.

   ✅ You’re connected! Check the Logs tab in Nango to inspect requests.

4. Implement Nango in your app

   Follow our quickstart 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.

Others

Function name	Description	Type	Source code
fetch-attachment	An action used to fetch the contents of an attachment.	Action	🔗 Github
emails	Fetches a list of emails from outlook. Goes back default to 1 year but metadata can be set using the backfillPeriodMs property to change the lookback. The property should be set in milliseconds.	Sync	🔗 Github
events	Sync calendar events on the primary calendar going back as specified in the metadata backfillPeriodMs, or fallback to 1 month if not provided.	Sync	🔗 Github
calendars	Sync the calendars list of the user	Sync	🔗 Github
folders	Fetches a list of folders from outlook.	Sync	🔗 Github

---