Microsoft Outlook
Read and update mail, send email, and manage calendar events
Connect Microsoft Outlook when a project needs mail or calendar data from a shared Microsoft account or from each published app user.
Available operations
| Operation | What it does | Permission | Limit per minute |
|---|---|---|---|
list_messages | Lists up to 50 messages | Read mail | 20 |
get_message | Reads one message | Read mail | 20 |
update_message | Changes read state or categories | Manage mail | 10 |
send_email | Sends one email to up to 50 recipients | Send mail | 10 |
list_events | Lists up to 50 events in a time range | Read calendars | 30 |
create_event | Creates one calendar event | Manage calendars | 10 |
update_event | Changes one calendar event | Manage calendars | 10 |
delete_event | Deletes one calendar event | Manage calendars | 10 |
Connect Microsoft Outlook
An administrator first configures Microsoft OAuth application and enables Microsoft Outlook under Admin > Settings > Integrations. Swarmz uses that application only to start Microsoft authorization; each person still signs in to Microsoft and grants access to their own account.
Ask the AI for the exact workflow and account owner. Examples:
- “Show unread Outlook mail in a customer support dashboard.”
- “Let each signed-in user send an Outlook email and create calendar events.”
Choose Connect new, select only the permissions the workflow needs, authorize Microsoft, then select Continue. For a published app-user connection, enter the app's final HTTPS origin before authorizing. See Connector connection modes.
Verify Microsoft Outlook
- List messages and confirm a known subject.
- Create a calendar event named
Swarmz connector testat a future time. - Update the event location, then confirm the change in Outlook.
- Delete the test event and confirm it no longer appears.
- If the product sends email, send one message to an address you control and confirm delivery.
If reads work but a write fails, reconnect and approve the matching write permission. Microsoft tenant policy can require administrator consent for some permissions. Disconnecting stops Swarmz from using the account but does not delete mail or calendar data. You can also revoke the grant in your Microsoft account.
Message and event bodies are limited to 64 KiB per operation. Generated code must call the connector gateway from an authenticated server route; it must not expose Microsoft tokens in browser code.