Skip to Content
IntegrationsMicrosoft Outlook

Microsoft Outlook

Connect a Microsoft account to send email and put events on its Outlook calendar from your processes. metamorphOS acts on the connected account through Microsoft Graph.

What you can do

  • Email: send a message on behalf of the connected account, with a subject, an HTML body, optional cc and bcc recipients, and file attachments.
  • Calendar: create an event with a subject, a description, and a start and end time.

Before you start

You need a Microsoft 365 or Outlook.com account, and permission to register an application in Microsoft Entra ID (the Azure portal). Registering an app usually requires an administrator, or a user your organization allows to create app registrations.

Set up Microsoft

  1. Register an application. In the Microsoft Entra admin center, go to Identity → Applications → App registrations, then New registration. Give it a name (for example, metamorphOS).
  2. Add the redirect URL. Under Authentication, add a Web redirect URI pointing at the callback URL metamorphOS provides.
  3. Grant permissions. Under API permissions, add Microsoft Graph → Delegated permissions and grant Mail.Send (send mail), Calendars.ReadWrite (create calendar events), and offline_access (so metamorphOS can keep the connection alive). Have an administrator grant consent if your organization requires it.
  4. Create a client secret. Under Certificates & secrets, add a new client secret and copy its value right away; Microsoft shows it only once. Note the application’s Application (client) ID as well.

Connect in metamorphOS

Activate the Microsoft Outlook connector from the marketplace and add an account. Enter the Application (client) ID and client secret from the step above, then complete the Microsoft sign-in and consent prompt. metamorphOS acts as the account you sign in with, so connect the mailbox you want messages and events to come from.

Good to know

  • This connector is early and intentionally narrow: it sends email and creates calendar events. It does not read mail, list events, or manage other Outlook data yet.
  • Email is sent as HTML and saved to the account’s Sent Items.
Last updated on
JiraMoodja