Skip to main content
Microsoft requires an organization administrator to grant consent before Microsoft mailboxes can be connected. Authorization does not automatically connect any mailboxes.

Authorize Microsoft

Organization authorization grants Stuut access to work with your Microsoft tenant and discover shared mailboxes. It is completed once by a Microsoft administrator.

Before you begin

You will need:
  • A Stuut organization administrator account
  • A Microsoft administrator account permitted to grant tenant-wide consent

Authorize your organization

  1. Open Settings → Mail in the Stuut dashboard.
  2. Find Microsoft in the Providers section.
  3. Enable Microsoft if it is not already enabled.
  4. Click Authorize.
  5. Sign into Microsoft with an organization administrator account.
  6. Review and approve the requested permissions.
  7. Return to Stuut and confirm that Microsoft appears as Authorized.

Application permissions

Microsoft application permissions are tenant-wide by default. Stuut uses them only for connected shared mailboxes.

Add mailboxes

After Microsoft is authorized, each shared or personal mailbox must be added to Stuut individually.

Shared mailboxes

Shared Microsoft mailboxes use the organization-approved application permissions described above. No one needs to sign in as the shared mailbox or provide its password. Each shared mailbox must be selected and connected individually.

Add a shared mailbox

  1. Open Settings → Mail.
  2. Click Add mailbox.
  3. Select Shared mailbox.
  4. Select Microsoft.
  5. Choose a shared mailbox discovered in your Microsoft tenant.
  6. Enter an optional display name.
  7. Choose whether to use it as a centralized inbox.
  8. Click Connect mailbox.

Personal mailboxes

Each user must sign into Microsoft and authorize their own mailbox. Personal mailboxes use delegated permissions associated with the signed-in user.

Delegated permissions

These delegated permissions apply to the signed-in account and any shared mailboxes that account is already permitted to access. Connecting one personal mailbox does not automatically connect other mailboxes in the organization.
Connecting a personal mailbox does not give Stuut organization-wide access. The connection uses the permissions and mailbox access already assigned to the signed-in Microsoft user.

Add a personal mailbox

  1. Open Settings → Mail.
  2. Click Add mailbox.
  3. Select Personal mailbox.
  4. Select Microsoft if prompted.
  5. Sign into the Microsoft account that owns the mailbox.
  6. Review and approve the requested access.
  7. Return to Stuut and confirm that the mailbox appears as connected.

Disconnect or revoke access

To stop using one mailbox, disconnect it from Settings → Mail. Existing communication history will be preserved. An organization administrator can revoke Microsoft access through the organization’s Microsoft Entra settings. Revoking organization access may affect every Microsoft mailbox connected through that authorization. Questions? Contact your Stuut team.