Connect Outlook Mail, Calendar, and OneDrive to your agents via Supyagent Cloud.

Microsoft 365 Integration

Microsoft 365 provides access to three services: Outlook Mail, Outlook Calendar, and OneDrive. Your agents can read and send emails, manage calendar events, and access files in your OneDrive.

OAuth Setup

When you click Connect Microsoft on the dashboard, Supyagent requests the following scopes:

Scope	Service	Access
`Mail.Read`	Outlook Mail	Read your emails
`Mail.Send`	Outlook Mail	Send emails on your behalf
`Calendars.ReadWrite`	Calendar	View and manage calendar events
`Files.ReadWrite`	OneDrive	Access and manage your files
`openid`	Profile	OpenID Connect authentication
`profile`	Profile	Read your basic profile
`email`	Profile	Read your email address
`offline_access`	Auth	Refresh tokens when they expire

Permissions

Permission ID	Name	Type	Description
`microsoft.mail.read`	Read emails	read	View and search your emails
`microsoft.mail.send`	Send emails	write	Send emails on your behalf
`microsoft.calendar.read`	Read calendar	read	View your calendar events
`microsoft.calendar.write`	Manage calendar	write	Create, update, and delete events
`microsoft.files.read`	Read files	read	View and download your files
`microsoft.files.write`	Manage files	write	Upload, create, and organize files

Outlook Mail

Example Actions

List recent emails:

curl -X GET "https://app.supyagent.com/api/v1/microsoft/mail/messages?limit=10" \
  -H "Authorization: Bearer sk_live_..."

Search emails:

curl -X GET "https://app.supyagent.com/api/v1/microsoft/mail/messages?search=quarterly+report" \
  -H "Authorization: Bearer sk_live_..."

Send an email:

curl -X POST "https://app.supyagent.com/api/v1/microsoft/mail/send" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "alice@company.com",
    "subject": "Q4 Report Draft",
    "body": "Hi Alice,\n\nPlease find the draft attached.\n\nBest regards"
  }'

What Agents Can Do

Search and list emails by sender, subject, date, or full-text search
Read email bodies and metadata
Send new emails
Reply to existing email threads

Outlook Calendar

Example Actions

List upcoming events:

curl -X GET "https://app.supyagent.com/api/v1/microsoft/calendar/events?days=7" \
  -H "Authorization: Bearer sk_live_..."

Create an event:

curl -X POST "https://app.supyagent.com/api/v1/microsoft/calendar/events" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Sprint Planning",
    "start": "2025-03-20T14:00:00",
    "end": "2025-03-20T15:00:00",
    "attendees": ["bob@company.com", "carol@company.com"]
  }'

What Agents Can Do

List events for any date range
Create, update, and cancel events
Add attendees and locations
Check free/busy availability

OneDrive

Example Actions

List files in root:

curl -X GET "https://app.supyagent.com/api/v1/microsoft/drive/files" \
  -H "Authorization: Bearer sk_live_..."

Search files:

curl -X GET "https://app.supyagent.com/api/v1/microsoft/drive/files?search=budget+2025" \
  -H "Authorization: Bearer sk_live_..."

What Agents Can Do

Browse files and folders
Search files by name or content
Download file contents
Upload new files
Create and organize folders

Notes

Microsoft tokens expire after 1 hour but are automatically refreshed using the offline_access scope
The Microsoft Graph API powers all three services under a unified authentication
Outlook search uses the Microsoft Search API, which supports natural language queries
OneDrive access includes both personal OneDrive and SharePoint document libraries

Microsoft 365

On this page