Connect an organization-wide Outlook account

An organization-wide Outlook account is the recommended way to connect Microsoft 365 to Tekst. A Microsoft 365 administrator grants Tekst tenant-wide access once, and Tekst then connects to mailboxes using application-level access that is not tied to any individual's sign-in. This means the connection keeps working when passwords are rotated or MFA is introduced.

For a comparison of this option with a personal account, see the "Outlook integration: personal vs organization-wide accounts" article.

What you need

• A Microsoft 365 administrator who can grant tenant-wide (admin) consent.
• Permission to add integrations in Tekst.

You do not need to register an application in Azure, create a client secret, or set up a dedicated mailbox or "service" user with MFA disabled. Tekst publishes its own Microsoft enterprise application, and the only thing the integration stores for an organization-wide connection is your tenant identifier. Granting consent is all that is required.

Step 1: Start the connection in Tekst

1. In Tekst, open Integrations from the navigation menu.
2. Click Connect Integration in the top-right corner.
3. Select Outlook from the list of providers.
4. When asked to choose an account type, select Organization-wide Outlook account.

Step 2: Grant admin consent in Microsoft 365

1. Tekst redirects you to Microsoft's consent screen. Sign in with an account that has administrator rights for your tenant.
2. Review the permissions Tekst is requesting. These are the application permissions described in Microsoft Graph permissions Tekst requests.
3. Accept on behalf of your organization. Microsoft records the consent for your tenant and returns you to Tekst automatically.

If consent is not granted by an administrator, the connection cannot be completed and Tekst will report that admin consent is missing.

Step 3: Choose which mailboxes to process

By default, an organization-wide connection can reach every mailbox in your tenant. We strongly recommend restricting it to only the mailboxes Tekst needs to process. See Restrict Tekst to specific mailboxes.

You can then add the individual mailboxes Tekst should monitor. See Add shared and child mailboxes.

Step 4: Finish setup

Complete the setup wizard. Once finished, the integration status changes to Connected and Tekst begins syncing. You can optionally include historical emails by enabling backfilling.

If the connection does not complete or later stops syncing, see the "Troubleshoot the Outlook integration" article.