Microsoft Outlook
OAuth2 connection to a Microsoft account for Outlook mail, calendar, and contacts.
Fields
| Field | Description | Required |
|---|---|---|
| Microsoft Account | Connected via OAuth2 — click "Connect Microsoft Outlook" and sign in. No keys to paste; Falcon Builder stores encrypted access and refresh tokens. | Yes |
Setup Steps
- Step 1: In Falcon Builder, go to Dashboard → Credentials → Add Credential and pick Microsoft Outlook.
- Step 2: Click Connect Microsoft Outlook. You'll be redirected to Microsoft to sign in and approve access.
- Step 3: Approve the requested permissions (mail, calendar, contacts). On managed/work tenants, an administrator may need to grant consent first.
- Step 4: You're returned to Falcon Builder with the account connected — the credential shows the signed-in email. No keys to copy or paste.
This is a standard OAuth2 connection — Falcon Builder uses its own Microsoft application registration, so you don't need to create an Azure app or manage a client secret yourself.
Permissions (Microsoft Graph scopes)
Requested during authorization:
Mail.ReadWrite/Mail.Send— read, draft, and send emailCalendars.ReadWrite— read and manage calendar eventsContacts.ReadWrite— read and manage contactsoffline_access— keep the connection alive (refresh tokens)openid,profile,email— identify the connected account
Token Management
Access and refresh tokens are encrypted and stored securely. Thanks to offline_access, tokens refresh automatically when they expire, so workflows keep running without re-authorizing. If a refresh ever fails (e.g. the account password changed or access was revoked), reconnect via the OAuth flow to restore access.
Testing the Connection
After connecting, click Test Credential to verify access. The test calls GET /me on Microsoft Graph and confirms the connected account. A 401 means the token expired (it will auto-refresh when a workflow runs); reconnect if the test keeps failing.