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. Its login email must be on your organization’s email domain, because Stuut uses this domain to find your Microsoft tenant.
  • A Microsoft administrator account permitted to grant tenant-wide consent
To limit Stuut to specific mailboxes, set up the application access policy in Limit Stuut to specific mailboxes after you authorize and before you add mailboxes.

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.
  8. Wait 5 minutes before you add mailboxes. Microsoft needs this time to apply the new permissions.

Application permissions

Microsoft application permissions are tenant-wide by default. Stuut uses them only for connected shared mailboxes. To enforce this in Microsoft, see Limit Stuut to specific mailboxes.

Limit Stuut to specific mailboxes

Your Exchange administrator can limit Stuut to approved mailboxes with an Exchange Online application access policy. Do this after you authorize Microsoft and before you add mailboxes.
  1. Ask your Stuut team for Stuut’s application (client) ID.
  2. Create a mail-enabled security group that contains the approved mailboxes.
  3. In Exchange Online PowerShell, create the policy:
  4. Wait up to 4 hours. Microsoft can take this long to apply the policy.
To approve another mailbox later, add it to the group.

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.