← Back to catalog

Productivity

Microsoft

Send mail, manage calendars, contacts, OneDrive files, OneNote, Teams messages, and SharePoint lists via Microsoft Graph.

swirls add microsoft
actionPOSTv1.0.0

Accept event

Accept a meeting invitation.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Add event attachment

Attach a file to a calendar event. Content is base64-encoded and limited to 3 MB.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Add message attachment

Attach a file to a draft message. Content is base64-encoded and limited to 3 MB; use it before sending the draft.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Cancel event

Cancel a meeting as its organizer and notify attendees.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Copy drive item

Copy a OneDrive file or folder. The copy is created asynchronously.

Files.ReadWrite
Source
actionPOSTv1.0.0

Copy message

Copy a message to another mail folder.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create calendar

Create a calendar for the signed-in user.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Create calendar event

Create an event in a specific calendar.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Create chat

Create a one-on-one or group Microsoft Teams chat. Members are bound by user id or userPrincipalName.

Chat.ReadWrite
Source
actionPOSTv1.0.0

Create contact

Create a contact in the signed-in user's contacts folder.

Contacts.ReadWrite
Source
actionPOSTv1.0.0

Create contact folder

Create a contact folder for the signed-in user.

Contacts.ReadWrite
Source
actionPOSTv1.0.0

Create contact in folder

Create a contact inside a specific contact folder.

Contacts.ReadWrite
Source
actionPOSTv1.0.0

Create draft

Create a draft message in the signed-in user's mailbox.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create event

Create an event in the signed-in user's default calendar.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Create folder

Create a folder inside a OneDrive folder. Use the get drive action or list actions to find parent ids; the root folder id is available via list root items.

Files.ReadWrite
Source
actionPOSTv1.0.0

Create forward draft

Create a draft forward of a message so it can be edited before sending.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create list item

Create an item in a SharePoint list.

Sites.ReadWrite.All
Source
actionPOSTv1.0.0

Create mail folder

Create a mail folder in the signed-in user's mailbox.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create message rule

Create an inbox message rule, e.g. move messages from a sender to a folder.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create notebook

Create a OneNote notebook for the signed-in user.

Notes.Create
Source
actionPOSTv1.0.0

Create page

Create a OneNote page in a section. Content is XHTML sent as the raw request body; the page title comes from the html title element.

Notes.Create
Source
actionPOSTv1.0.0

Create reply draft

Create a draft reply to a message so it can be edited before sending.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Create section

Create a section in a OneNote notebook.

Notes.Create
Source
actionPOSTv1.0.0

Create sharing link

Create a sharing link for a OneDrive file or folder.

Files.ReadWrite
Source
actionPOSTv1.0.0

Decline event

Decline a meeting invitation, optionally proposing a new time.

Calendars.ReadWrite
Source
actionDELETEv1.0.0

Delete calendar

Delete a calendar.

Calendars.ReadWrite
Source
actionDELETEv1.0.0

Delete contact

Delete a contact from the signed-in user's contacts folder.

Contacts.ReadWrite
Source
actionDELETEv1.0.0

Delete drive item

Delete a OneDrive file or folder. The item moves to the recycle bin.

Files.ReadWrite
Source
actionDELETEv1.0.0

Delete event

Delete a calendar event.

Calendars.ReadWrite
Source
actionDELETEv1.0.0

Delete list item

Delete an item from a SharePoint list.

Sites.ReadWrite.All
Source
actionDELETEv1.0.0

Delete mail folder

Delete a mail folder and its contents.

Mail.ReadWrite
Source
actionDELETEv1.0.0

Delete message

Delete a message from the signed-in user's mailbox.

Mail.ReadWrite
Source
actionDELETEv1.0.0

Delete page

Delete a OneNote page.

Notes.ReadWrite
Source
actionGETv1.0.0

Download drive file

Download the content of a file from any drive by drive id, such as a SharePoint document library. Returns the file body as text, so it is best suited to text-based files.

Sites.Read.All
Source
actionGETv1.0.0

Download file

Download the content of a OneDrive file. Returns the file body as text, so it is best suited to text-based files.

Files.ReadWrite
Source
actionPOSTv1.0.0

Forward event

Forward a meeting to other recipients.

Calendars.ReadWrite
Source
actionPOSTv1.0.0

Forward message

Forward a message to one or more recipients as the signed-in user.

Mail.Send
Source
actionGETv1.0.0

Get calendar

Fetch a calendar by id.

Calendars.ReadWrite
Source
actionGETv1.0.0

Get calendar view

List calendar events within a time window, with recurring events expanded to occurrences.

Calendars.ReadWrite
Source
actionGETv1.0.0

Get chat

Fetch a Microsoft Teams chat by id.

Chat.ReadWrite
Source
actionGETv1.0.0

Get chat message

Fetch a single message from a Microsoft Teams chat.

Chat.ReadWrite
Source
actionGETv1.0.0

Get contact

Fetch a single contact by id.

Contacts.Read
Source
actionGETv1.0.0

Get drive

Fetch the signed-in user's OneDrive metadata, including its id and storage quota.

Files.ReadWrite
Source
actionGETv1.0.0

Get drive item

Fetch metadata for a OneDrive file or folder by item id.

Files.ReadWrite
Source
actionGETv1.0.0

Get event

Fetch a single calendar event by id.

Calendars.ReadWrite
Source
actionGETv1.0.0

Get list

Fetch a SharePoint list, including its columns when expanded.

Sites.Read.All
Source
actionGETv1.0.0

Get list item

Fetch a single SharePoint list item. Pass $expand=fields to include column values.

Sites.Read.All
Source
actionGETv1.0.0

Get mail folder

Fetch a mail folder by id or well-known name.

Mail.ReadWrite
Source
actionGETv1.0.0

Get mailbox settings

Fetch the signed-in user's mailbox settings, including time zone, locale, and automatic replies.

MailboxSettings.Read
Source
actionGETv1.0.0

Get message

Fetch a single message from the signed-in user's mailbox by id.

Mail.ReadWrite
Source
actionGETv1.0.0

Get message attachment

Fetch a single message attachment, including its base64 contentBytes for file attachments.

Mail.ReadWrite
Source
actionGETv1.0.0

Get my profile

Fetch the signed-in user's profile.

User.Read
Source
actionGETv1.0.0

Get notebook

Fetch a OneNote notebook by id.

Notes.Read
Source
actionGETv1.0.0

Get page content

Fetch the HTML content of a OneNote page. Returns HTML text, not JSON.

Notes.Read
Source
actionPOSTv1.0.0

Get schedule

Get free/busy availability for one or more users or rooms in a time window.

Calendars.ReadWrite
Source
actionGETv1.0.0

Get site

Fetch a SharePoint site by its composite id (from search sites results).

Sites.Read.All
Source
actionGETv1.0.0

List calendar events

List events in a specific calendar.

Calendars.ReadWrite
Source
actionGETv1.0.0

List calendars

List the signed-in user's calendars.

Calendars.ReadWrite
Source
actionGETv1.0.0

List chat members

List the members of a Microsoft Teams chat.

Chat.ReadWrite
Source
actionGETv1.0.0

List chat messages

List messages in a Microsoft Teams chat, newest first.

Chat.ReadWrite
Source
actionGETv1.0.0

List chats

List the signed-in user's Microsoft Teams chats.

Chat.ReadWrite
Source
actionGETv1.0.0

List contact folders

List the signed-in user's contact folders.

Contacts.Read
Source
actionGETv1.0.0

List contacts

List the signed-in user's contacts.

Contacts.Read
Source
actionGETv1.0.0

List drive items

List files and folders inside a folder of any drive by drive id, such as a SharePoint document library.

Sites.Read.All
Source
actionGETv1.0.0

List drive root items

List files and folders in the root of any drive by drive id, such as a SharePoint document library.

Sites.Read.All
Source
actionGETv1.0.0

List event instances

List the occurrences of a recurring event within a time window.

Calendars.ReadWrite
Source
actionGETv1.0.0

List events

List events in the signed-in user's default calendar.

Calendars.ReadWrite
Source
actionGETv1.0.0

List folder contacts

List contacts in a specific contact folder.

Contacts.Read
Source
actionGETv1.0.0

List folder items

List files and folders inside a OneDrive folder by item id.

Files.ReadWrite
Source
actionGETv1.0.0

List folder messages

List messages in a specific mail folder. Well-known folder names like inbox, drafts, sentitems, and deleteditems work as the folder id.

Mail.ReadWrite
Source
actionGETv1.0.0

List list items

List items in a SharePoint list. Pass $expand=fields to include column values.

Sites.Read.All
Source
actionGETv1.0.0

List mail folders

List the mail folders in the signed-in user's mailbox.

Mail.ReadWrite
Source
actionGETv1.0.0

List message rules

List the inbox message rules for the signed-in user.

Mail.ReadWrite
Source
actionGETv1.0.0

List messages

List messages in the signed-in user's mailbox, newest first by default.

Mail.ReadWrite
Source
actionGETv1.0.0

List notebook sections

List the sections in a specific OneNote notebook.

Notes.Read
Source
actionGETv1.0.0

List notebooks

List the signed-in user's OneNote notebooks.

Notes.Read
Source
actionGETv1.0.0

List pages

List OneNote pages across the signed-in user's notebooks.

Notes.Read
Source
actionGETv1.0.0

List recent files

List drive items recently used by the signed-in user.

Files.ReadWrite
Source
actionGETv1.0.0

List root items

List files and folders in the root of the signed-in user's OneDrive.

Files.ReadWrite
Source
actionGETv1.0.0

List section pages

List the pages in a specific OneNote section.

Notes.Read
Source
actionGETv1.0.0

List sections

List OneNote sections across the signed-in user's notebooks.

Notes.Read
Source
actionGETv1.0.0

List site drives

List the document libraries of a SharePoint site. Use the returned drive ids with the drive item actions.

Sites.Read.All
Source
actionGETv1.0.0

List site lists

List the lists in a SharePoint site.

Sites.Read.All
Source
actionGETv1.0.0

List subsites

List the subsites of a SharePoint site.

Sites.Read.All
Source
actionPOSTv1.0.0

Move message

Move a message to another mail folder.

Mail.ReadWrite
Source
actionPOSTv1.0.0

Reply all to message

Reply to all recipients of a message as the signed-in user.

Mail.Send
Source
actionPOSTv1.0.0

Reply to channel message

Reply to a message in a Microsoft Teams channel thread.

ChannelMessage.Send
Source
actionPOSTv1.0.0

Reply to message

Reply to the sender of a message as the signed-in user.

Mail.Send
Source
actionGETv1.0.0

Search drive

Search the signed-in user's OneDrive by file name or content.

Files.ReadWrite
Source
actionGETv1.0.0

Search sites

Search SharePoint sites the signed-in user can access.

Sites.Read.All
Source
actionPOSTv1.0.0

Send channel message

Send a message to a Microsoft Teams channel. Requires the team and channel ids.

ChannelMessage.Send
Source
actionPOSTv1.0.0

Send chat message

Send a message to a Microsoft Teams chat as the signed-in user.

Chat.ReadWrite
Source
actionPOSTv1.0.0

Send draft

Send an existing draft message.

Mail.Send
Source
actionPOSTv1.0.0

Send mail

Send an email as the signed-in user.

Mail.Send
Source
actionPOSTv1.0.0

Tentatively accept event

Tentatively accept a meeting invitation.

Calendars.ReadWrite
Source
actionPATCHv1.0.0

Update calendar

Rename or recolor a calendar.

Calendars.ReadWrite
Source
actionPATCHv1.0.0

Update chat

Update the topic of a group chat.

Chat.ReadWrite
Source
actionPATCHv1.0.0

Update contact

Update properties of an existing contact.

Contacts.ReadWrite
Source
actionPATCHv1.0.0

Update drive item

Rename a OneDrive file or folder, or move it by setting a new parent.

Files.ReadWrite
Source
actionPATCHv1.0.0

Update event

Update properties of an existing calendar event.

Calendars.ReadWrite
Source
actionPATCHv1.0.0

Update list item

Update column values on a SharePoint list item. Every property other than the ids is written as a column value.

Sites.ReadWrite.All
Source
actionPATCHv1.0.0

Update message

Update message properties such as read state, categories, flag, or importance. Subject and body can only be changed on drafts.

Mail.ReadWrite
Source
actionPUTv1.0.0

Upload drive file

Upload a file into a folder of any drive by drive id, such as a SharePoint document library. Content is sent as the raw request body; simple uploads are limited to 4 MB.

Sites.ReadWrite.All
Source
actionPUTv1.0.0

Upload file

Upload a file into a OneDrive folder by parent id. Content is sent as the raw request body; simple uploads are limited to 4 MB.

Files.ReadWrite
Source
actionPUTv1.0.0

Upload file to root

Upload a file into the root of the signed-in user's OneDrive. Content is sent as the raw request body; simple uploads are limited to 4 MB.

Files.ReadWrite
Source
Beyond the catalog

Any provider, on request.

01

Request it

Tell us the provider. We ship it in the registry.

02

Generate it

Point swirls add at an OpenAPI or GraphQL spec. Typed actions for any API you hold credentials for, today.

acme · integrations
terminal
~/acme $swirls add linear
✓ 12 typed actions · scopes and schemas included
 
~/acme $swirls add https://api.acme.dev/openapi.json
◆ Fetched spec · 38 operations
✓ 6 typed actions · generated from spec