Connect Automagically to your clients’ Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.
Automagically is currently in a closed beta.
Automagically runs IT automation in your clients’ Microsoft 365 tenants. This page covers how it connects to each tenant, what you set up once as an admin, what each technician does, and how to fix the common problems.
What you get
GDAP clients connected with no client action. Automagically is authorized in each GDAP client through Partner Center. The client’s admin doesn’t click anything.
Per-technician access. In GDAP clients, Automagically acts with each technician’s own GDAP roles, and operations show under that technician in the client’s Microsoft audit logs.
Direct clients too. Clients you don’t manage through GDAP connect with a one-time admin consent link.
Your own tenant and a test tenant. Connect your MSP tenant for internal automation, and a staging tenant to test runbooks safely.
How the connection works (read this first)
GDAP clients are connected in two layers, and you need both:
The workspace connection (admin, once). Connect Partner Center and set up your GDAP app. This tells Automagically which clients you manage and lets it authorize itself in them.
Each technician’s sign-in (every technician, once each). Every technician who runs automations in GDAP clients connects their own Microsoft account. Automagically then acts with that technician’s GDAP roles: a technician can never do more through Automagically than their GDAP access allows.
If automations work for one technician but not another on the same GDAP client, it’s almost always layer 2.
Application vs delegated permissions. Application permissions give the app its own standing access to a tenant, so operations run as “the app”. Delegated permissions let the app act on behalf of a signed-in person, limited to their roles and recorded under their identity. Direct clients, your MSP tenant and your staging tenant use application permissions. GDAP clients use delegated permissions.
Connection
Who sets it up
Least privilege required
Needed for
Partner Center
Admin, once
Admin Agent (Partner Center) and Application Administrator (Entra ID), in your own partner tenant
GDAP clients
GDAP app
Admin, once
Cloud Application Administrator or higher, in your own tenant
GDAP clients
GDAP client authorization
Automatic
Cloud Application Administrator, Application Administrator or Global Administrator in an active GDAP relationship with the client
Each GDAP client
Your Microsoft sign-in
Each technician, once
Member of the GDAP security groups that hold the required roles
Running automations in GDAP clients
Admin consent
The client’s Microsoft admin
Application Administrator in the client tenant
Each direct client
MSP tenant and staging
Admin
Application Administrator in the target tenant
Internal automation and testing
Connect GDAP clients
Step 1: Connect Partner Center (admin)
Connecting Partner Center lets Automagically discover the clients you manage through GDAP and authorize itself in them.You need an account that is an Admin Agent in Partner Center and holds Application Administrator (or higher) in Entra ID. You can remove Application Administrator from the account once the connection is made. It’s only needed again if you reconnect.
Use a dedicated service account where possible. The connection is tied to the account that made it. If that account’s password changes, its MFA is reset or it’s disabled, Partner Center shows Reconnect needed until someone signs in again.
The account must belong to your own partner tenant:
It must be a member of the tenant, not a guest.
It doesn’t have to be your Thread login. A separate privileged admin account works.
Your Thread login’s email domain must be a verified domain in that tenant, and your Thread email must exist as a user there.
If your Partner Center is in a different tenant from your email domain, contact Thread support before you connect.
1
Open the Microsoft 365 connect flow
In Automagically, go to Integrations. On the Microsoft 365 card, open Connect clients, then click Connect with GDAP. (During onboarding, the same option is on the clients step.)
2
Connect Partner Center
Click Connect Partner Center and sign in with your partner tenant account. Complete MFA: Microsoft requires it for Partner Center.
3
Approve the permissions
Approve the permissions listed below.
Automagically checks the account belongs to your partner tenant. Partner Center then appears on the Microsoft 365 card as Connected, and the wizard lists your GDAP tenants.
Permission
Why Automagically needs it
DelegatedAdminRelationship.Read.All
Reads your GDAP relationships, to discover your clients and check their roles.
Partner Center user_impersonation
Authorizes your GDAP app in your clients through Partner Center.
User.Read, User.ReadWrite.All
Confirm which tenant the signing-in account belongs to.
openid, profile, email, offline_access
Identify the signed-in admin and keep the connection alive.
Why does Partner Center need User.ReadWrite.All?
When you connect, Automagically checks that the account belongs to your own partner tenant and that your Thread email is a user there. That protects you from someone connecting your Partner Center to a different Thread workspace. Microsoft accepts this permission for the user lookup, and the Automagically app already holds it, so the connection asks for nothing new. Automagically only reads with it during the connect.
Step 2: Set up your GDAP app (admin)
Microsoft only lets a partner authorize an app in its customers through Partner Center when the partner owns the app. So Automagically creates a copy of its app in your own tenant, owned by you, called Automagically - M365 GDAP. All GDAP work runs as this app.
Two apps, one product.Automagically - M365 (Thread’s app) is used for direct clients and your MSP and staging tenants. Automagically - M365 GDAP (your copy, with the same permissions) is used for your GDAP clients. You’ll see both in your Entra tenant.
You need Cloud Application Administrator or higher (for example Application Administrator or Global Administrator) in your own tenant. Partner Center must be connected first.
1
Start the GDAP app setup
On the Microsoft 365 card, click Set up on the GDAP app row.
2
Approve two temporary permissions
Sign in to the same tenant you connected Partner Center with, and approve two temporary permissions for Thread’s app: Application.ReadWrite.All (to create your app) and DelegatedPermissionGrant.ReadWrite.All (to remove both permissions again afterwards).
3
Automagically creates your app
Automagically creates Automagically - M365 GDAP with its own certificate, and removes the two temporary permissions from Thread’s app straight away.
4
Grant consent for the new app
These are the same Microsoft Graph, Exchange and SharePoint permissions the Automagically app already uses. Until you do, the row shows Consent pending.
5
Connect Partner Center again, as the new app
Until you do, the row shows Partner Center pending. The row then shows Active.
The flow takes about a minute. A sign-in from any tenant other than your Partner Center tenant is refused.When the app becomes active:
Every GDAP client you’ve already mapped is authorized automatically.
Each technician reconnects Your Microsoft sign-in once, because their earlier sign-in was made with Thread’s app.
Direct clients aren’t affected.
The app’s certificate lasts 2 years. The row shows Expires soon when it’s due. Contact Thread support to renew it.
Step 3: Map and authorize your GDAP clients (admin)
On the Microsoft 365 clients page, click Connect with GDAP and map each client to its Microsoft tenant. Automagically then authorizes your GDAP app in that client through Partner Center, applies the app’s permissions and checks the client’s GDAP roles. The client’s admin doesn’t do anything.Authorization also runs:
For every mapped client, when your GDAP app becomes active.
When you click Authorize on a client.
For all clients, when you click Authorize all GDAP clients. Tick Also update clients authorized with an older permission list to bring older authorizations up to date.
Each client needs an active GDAP relationship that grants Cloud Application Administrator, Application Administrator or Global Administrator to a security group your Partner Center account is in.Each GDAP client shows one of these statuses in the Partner Center column of the clients table.
Status
What it means
Authorizing
Authorization is running.
Authorized
The app is authorized with its current permissions.
Permissions out of date
The app is authorized with an older permission list. Run Authorize all GDAP clients with the update option ticked.
Temporary failure
Partner Center was busy or unavailable. Automagically retries for up to about 90 minutes.
Update failed
Updating an earlier authorization failed. The earlier one still works. The client shows the reason and the fix.
Failed
Authorization couldn’t complete. The client shows the reason and the fix.
Not authorized
Authorization hasn’t run yet.
A client you Disconnect stays disconnected until you click Authorize on it. Discovering, mapping again or Authorize all GDAP clients won’t reconnect it.
Step 4: Each technician connects their Microsoft account
Every technician who runs automations in GDAP clients signs in once:
1
Open Your Microsoft sign-in
In Automagically, go to Integrations and find Your Microsoft sign-in on the Microsoft 365 card. The row appears once your workspace has a GDAP client.
2
Connect your Microsoft account
Click Connect and sign in with your own Microsoft work account: the one your Thread login uses, which holds your GDAP access.
3
Confirm the row shows Connected
The row shows Connected.
When you run an automation in a GDAP client, Automagically asks Microsoft for access to that client on your behalf, and Microsoft only grants what your GDAP roles allow there.You stay connected from then on: Automagically refreshes idle Partner Center and technician sign-ins daily. If Microsoft stops accepting a sign-in, the row shows Reconnect needed and why.
Required GDAP roles
Automagically checks each GDAP client’s relationships for these roles. A client connects as long as it has at least one, and lists any that are missing. Automations that need a missing role fail in that client. A client with none of them shows Failed.
Role
Why it’s needed
Application Administrator
App registration and consent management.
Authentication Policy Administrator
Authentication methods and MFA policies.
Cloud Device Administrator
Device management in Entra ID.
Exchange Administrator
Mailbox and mail flow management.
Global Reader
Read-only access across all services for discovery.
Intune Administrator
Endpoint and device policy management.
Privileged Authentication Administrator
Reset passwords and manage authentication for all users.
Privileged Role Administrator
Manage role assignments in Entra ID.
Security Administrator
Security policies and incident management.
SharePoint Administrator
SharePoint Online and OneDrive management.
Teams Administrator
Microsoft Teams configuration and policies.
User Administrator
User lifecycle: creation, licensing, group membership.
Technicians must be members of the GDAP security groups these roles are assigned to in Partner Center.
When no technician sign-in is available. A run a technician starts in a GDAP client always uses that technician’s own sign-in, including runs a flow or automation makes on a technician’s behalf. If Automagically can’t use it, for example because it needs reconnecting or was never connected, the run stops and asks the technician to connect Your Microsoft sign-in. It never falls back to the Automagically app’s own permissions. The only exception is an intent run the Triage Agent starts with no technician behind it: it can use application permissions when the client’s own admin has also consented the Automagically app directly. Those operations aren’t recorded under a technician.
Connect direct clients
For clients you don’t manage through GDAP, the client’s Microsoft admin approves the Automagically app once. They don’t need a Thread account.
1
Find the client
Open Microsoft 365 clients and find the client.
2
Share the consent link
Click Copy link and send it to the client’s Microsoft admin (Application Administrator or higher), or click Connect to complete it yourself if you’re an admin in their tenant.
3
Admin approves the permissions
The admin signs in and approves the permissions. The client then shows as connected.
Sign in as the right admin. Microsoft reuses whichever account your browser is already signed in to. If the consent comes back with your staging tenant, or a tenant another of your clients already uses, Automagically refuses it and saves nothing. Open the link in a private window, or send it to the client’s admin.
The consent covers everything Automagically can automate in that one tenant: users and groups, sign-in and MFA, mail and Exchange, Teams, SharePoint and OneDrive, Intune devices and security policy. See What the permissions are for below for the full list.DAP clients. Partner Center also discovers clients you still manage through DAP, the older Delegated Admin Privileges. They connect with admin consent, like direct clients. Microsoft recommends moving them to GDAP.
What the permissions are for
When a client’s admin approves Automagically - M365, or you grant consent for Automagically - M365 GDAP, Microsoft shows a long list of permissions. It’s long for three reasons.
Most permissions appear twice. The first half of the list is application permissions, worded like “…in all mailboxes” or “…all site collections”. Automagically uses them for direct clients, your MSP tenant and your staging tenant. The second half is the matching delegated permissions, worded like “…user mail” or “Send mail as a user”. Automagically uses them in GDAP clients, where it acts as the signed-in technician and can’t do more than that technician’s GDAP roles allow.
One consent covers every runbook. Consent is given once per tenant, not once per runbook, so the app asks for what every supported runbook might need. What actually runs is still controlled by runbook approval, Automagically roles, and (in GDAP clients) each technician’s GDAP roles.
Some areas use more than one Microsoft API. “Have full control of all site collections” appears four times because it’s granted in both Microsoft Graph and SharePoint, each as an application and a delegated permission. The “Manage Exchange…” permissions come from Exchange Online, because tasks like mail forwarding, shared mailboxes and mailbox permissions aren’t available in Microsoft Graph.
Area
Permissions you’ll see
Why Automagically needs them
Partner and GDAP
Read Delegated Admin relationships with customers
Discover your GDAP clients and check which roles each relationship grants.
Tenant basics
Read organization information, Sign in and read user profile, Read all usage reports, Read all audit log data
Identify the tenant, read licence and usage data, and check what a run changed.
Users and groups
Read and write directory data, Read and write all users’ full profiles, Read and write all groups
Onboarding and offboarding, licensing and group membership.
Admin roles
Read and write all directory RBAC settings
Runbooks that change role assignments. During setup, Automagically also uses it to give its own app the Exchange Administrator role, which Microsoft requires before an app can run Exchange tasks.
Sign-in and MFA
Read and write all password profiles and reset user passwords, Read and write all users’ authentication methods, Read all users’ password authentication methods
Password resets, MFA registration and reset, and recovering a user who lost their device.
Security
Read and write your organization’s conditional access policies, Read your organization’s policies, Read and write all risky user information, Read all security alerts, Read your organization’s security events
Conditional Access changes, confirming or dismissing risky users, and triaging security alerts.
Mail and calendar
Read and write mail in all mailboxes, Send mail as any user, Read and write all user mailbox settings, Read and write calendars in all mailboxes
Out-of-office replies, delegate access, mail cleanup and calendar permissions.
Exchange
Manage Exchange As Application, Manage Exchange as application v2, Manage Exchange configuration
Exchange tasks that Microsoft Graph can’t do: mail forwarding, shared mailboxes, mailbox permissions and mail flow rules.
Teams
Create channels, Read the members of all channels, Add and remove members from all channels
Team and channel setup, and membership changes during onboarding and offboarding.
SharePoint and OneDrive
Have full control of all site collections, Read items in all site collections, Read and write files in all site collections
Site permissions, external sharing, and handing over a leaver’s OneDrive.
Intune
Read and write Microsoft Intune devices
Device lookups, sync, retire and wipe.
Connect your staging tenant
Staging tenant: on the Microsoft 365 card, click Connect staging tenant to link a test tenant and try runbooks before they reach real clients. You can finish setup with only a staging tenant and connect clients later.
Troubleshooting
Symptom
Cause
Fix
Partner Center connect says the account is a guest
You signed in with a guest account in your partner tenant
Sign in with an account that’s a member of your own partner tenant.
Partner Center connect says your tenant hasn’t verified your Thread email’s domain
You signed in to a different tenant, or your Partner Center is in a separate tenant from your email domain
Sign in to the tenant that owns your email domain with its Admin Agent account. If your Partner Center really is in a separate tenant, contact Thread support.
Partner Center or Your Microsoft sign-in shows Reconnect needed
Microsoft ended the sign-in (for example after a password change), now requires MFA, or a Conditional Access policy blocked it
Click Reconnect, sign in again and complete MFA.
A GDAP client fails with “no role that can authorize the app”
No active GDAP relationship grants Cloud Application Administrator, Application Administrator or Global Administrator
Add one of those roles to an active GDAP relationship and click Authorize, or connect the client directly.
A GDAP client fails because of Conditional Access
The client’s Conditional Access policies block your partner sign-ins
Ask the client’s admin to exclude your partner sign-ins from the policy.
A GDAP client lists missing roles
Its GDAP relationship doesn’t grant every required role
Automations that need those roles fail in that client. Add the roles to a GDAP relationship.
Direct consent says the tenant is already connected to another client
Your browser was signed in as another admin, so Microsoft returned the wrong tenant
Open the link in a private window and sign in as the client’s admin. If the client really shares that tenant with another client, first add a contact on one of the tenant’s email domains to the client.
Automations work for one technician but not another
That technician hasn’t connected Your Microsoft sign-in, or isn’t in the right GDAP security groups
Have them connect their Microsoft account (Step 4) and check their GDAP group membership.
FAQ
Do my clients need to do anything?
GDAP clients: no, Automagically is authorized through Partner Center. Direct clients: their Microsoft admin approves a consent link once. Neither needs a Thread account.
Can I connect Partner Center with a separate admin account?
Yes, as long as it’s a member (not a guest) of your own partner tenant and your Thread email is a user in that tenant.
What happens when a technician leaves?
Their sign-in stops working once their Microsoft account is disabled. Nothing shared is affected, and other technicians carry on with their own accounts.
Can I have both GDAP and direct clients?
Yes. To move a client that’s working on a direct connection to GDAP, map it over GDAP. Automagically asks you to confirm first, because it changes how that client connects.
What is CPV, and why doesn't Automagically need it?
Control Panel Vendor (CPV) is a Microsoft program that lets a vendor’s app be authorized in partners’ customers. Automagically creates a copy of its app that you own instead, and Microsoft lets partners authorize their own apps in their customers, so no CPV enrollment is needed.
Is authorization per client or global?
Per client. Each tenant is authorized independently, so you control which tenants Automagically can access.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Thread Docs","colors":{"primary":"#00B398","light":"#19D3AB","dark":"#008E78"},"logo":{"light":"https://mintcdn.com/thread/50guKpC0vegpyObR/logo/thread.svg?fit=max\u0026auto=format\u0026n=50guKpC0vegpyObR\u0026q=85\u0026s=86145b5e0fe1e4b555128fc8d8fd9815","dark":"https://mintcdn.com/thread/2AdmqP0mlnyoZLRc/logo/dark.svg?fit=max\u0026auto=format\u0026n=2AdmqP0mlnyoZLRc\u0026q=85\u0026s=be32bb55d8f9cb7540f7c741c3568f92"},"favicon":"https://mintcdn.com/thread/hgBTJ4Ailw9NcSXS/favicon.svg?fit=max\u0026auto=format\u0026n=hgBTJ4Ailw9NcSXS\u0026q=85\u0026s=e5c9cc06837f1f692d72495e146c976a","appearance":{"default":"dark"},"background":{"color":{"light":"#FAF9F6","dark":"#0A0A0B"}},"navbar":{"links":[{"href":"https://www.getthread.com/aisu-community","label":"Community"}],"primary":{"type":"button","label":"Thread Inbox","href":"https://inbox.getthread.com"}},"footer":{"socials":{"website":"https://www.getthread.com","linkedin":"https://www.linkedin.com/company/thread-service","youtube":"https://www.youtube.com/channel/UCAZ535tVfwF94lOE818tVmQ"},"links":[{"header":"Our mission","items":[{"label":"Death to the Ticket","href":"https://www.getthread.com/death-to-ticket"},{"label":"Intelligent Service Delivery","href":"https://www.getthread.com/intelligent-service-delivery-manifesto-the-future-of-msp-operations"}]},{"header":"Popular features","items":[{"label":"AI Agents","href":"https://www.getthread.com/automated-ticket-triage"},{"label":"Automated Triage","href":"https://www.getthread.com/automated-ticket-triage"},{"label":"Service Desk Chatbots","href":"https://www.getthread.com/live-managed-chat-support"},{"label":"Teams Chat Integration","href":"https://www.getthread.com/teams-to-teams"},{"label":"AI for Phone","href":"https://www.getthread.com/voice-ai"}]},{"header":"Company","items":[{"label":"About","href":"https://www.getthread.com/about-thread"},{"label":"Careers","href":"https://www.getthread.com/careers"}]},{"header":"Resources","items":[{"label":"AISU Community","href":"https://www.getthread.com/aisu-community"},{"label":"Thread Crew","href":"https://thread-crew.circle.so/join?invitation_token=8c546a98539fb84b4eb913b8b647a078bb353623-ea2d128e-eaae-42fd-af14-5949e71bf51b"},{"label":"AISU weekly webinar","href":"https://www.getthread.com/aisu-weekly-registration"},{"label":"Events","href":"/events-and-resources"},{"label":"Blog","href":"https://www.getthread.com/service-magic-blog"},{"label":"System Status","href":"https://status.getthread.com/"},{"label":"Feedback","href":"https://feedback.getthread.com/"},{"label":"Contact support","href":"https://help.getthread.com"},{"label":"Trust Center","href":"https://trust.getthread.com"},{"label":"Terms of Service","href":"https://www.getthread.com/terms-of-service"},{"label":"Privacy Policy","href":"https://www.getthread.com/privacy-policy"}]}]},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter"}},"banner":{"content":"Join hundreds of MSPs on the **AI Service Unleashed** weekly call — product releases, beta access, and Super Magic tips. [Register](https://www.getthread.com/aisu-weekly-registration)","dismissible":true},"contextual":{"options":["copy","view","assistant","claude","chatgpt","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"thread","hasAudioNarration":false,"actualSubdomain":"thread","customDomains":["docs.getthread.com"],"gitSource":{"type":"github","owner":"thread-magic","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true,"edits":false},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afcb926b6d2e782db02cf8d","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Guides","count":225},{"language":"default","tag":"Super Magic \u0026 Thread MCP","count":36},{"language":"default","tag":"By role","count":28},{"language":"default","tag":"Choose your role","count":28},{"language":"default","tag":"Integrations","count":24},{"language":"default","tag":"Messenger","count":22},{"language":"default","tag":"Super Magic Tools","count":21},{"language":"default","tag":"Thread Inbox","count":20},{"language":"default","tag":"Voice AI","count":19},{"language":"default","tag":"Magic Agents","count":16}],"searchSettings":{"isFiltersEnabled":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"type":"email","email":"help@getthread.com","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/thread/7dad7b024a7096a6/style.css"}],"page":{"pagePath":"automagically/connect-microsoft-365-clients","slug":"/automagically/connect-microsoft-365-clients","pageMetadata":{"title":"Connect Microsoft 365 clients","sidebarTitle":"Connect Microsoft 365 clients","description":"Connect Automagically to your clients' Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.","boost":3,"href":"/automagically/connect-microsoft-365-clients"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Automagically to your clients’ Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Heading,Info,Note,Step,Steps,Table,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`Automagically is currently in a `,_jsx(_components.strong,{children:`closed beta`}),`.`]})}),`\n`,_jsx(_components.p,{children:`Automagically runs IT automation in your clients’ Microsoft 365 tenants. This page covers how it connects to each tenant, what you set up once as an admin, what each technician does, and how to fix the common problems.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-get`,children:`What you get`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`GDAP clients connected with no client action.`}),` Automagically is authorized in each GDAP client through Partner Center. The client’s admin doesn’t click anything.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Per-technician access.`}),` In GDAP clients, Automagically acts with each technician’s own GDAP roles, and operations show under that technician in the client’s Microsoft audit logs.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Direct clients too.`}),` Clients you don’t manage through GDAP connect with a one-time admin consent link.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Your own tenant and a test tenant.`}),` Connect your MSP tenant for internal automation, and a staging tenant to test runbooks safely.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`how-the-connection-works-read-this-first`,children:`How the connection works (read this first)`}),`\n`,_jsx(_components.p,{children:`GDAP clients are connected in two layers, and you need both:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`The workspace connection (admin, once).`}),` Connect Partner Center and set up your GDAP app. This tells Automagically which clients you manage and lets it authorize itself in them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Each technician’s sign-in (every technician, once each).`}),` Every technician who runs automations in GDAP clients connects their own Microsoft account. Automagically then acts with that technician’s GDAP roles: a technician can never do more through Automagically than their GDAP access allows.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`If automations work for one technician but not another on the same GDAP client, it’s almost always layer 2.`}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Application vs delegated permissions.`}),` Application permissions give the app its own standing access to a tenant, so operations run as “the app”. Delegated permissions let the app act on behalf of a signed-in person, limited to their roles and recorded under their identity. Direct clients, your MSP tenant and your staging tenant use application permissions. GDAP clients use delegated permissions.`]})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Connection`}),_jsx(_components.th,{children:`Who sets it up`}),_jsx(_components.th,{children:`Least privilege required`}),_jsx(_components.th,{children:`Needed for`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Partner Center`}),_jsx(_components.td,{children:`Admin, once`}),_jsx(_components.td,{children:`Admin Agent (Partner Center) and Application Administrator (Entra ID), in your own partner tenant`}),_jsx(_components.td,{children:`GDAP clients`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GDAP app`}),_jsx(_components.td,{children:`Admin, once`}),_jsx(_components.td,{children:`Cloud Application Administrator or higher, in your own tenant`}),_jsx(_components.td,{children:`GDAP clients`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`GDAP client authorization`}),_jsx(_components.td,{children:`Automatic`}),_jsx(_components.td,{children:`Cloud Application Administrator, Application Administrator or Global Administrator in an active GDAP relationship with the client`}),_jsx(_components.td,{children:`Each GDAP client`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Your Microsoft sign-in`}),_jsx(_components.td,{children:`Each technician, once`}),_jsx(_components.td,{children:`Member of the GDAP security groups that hold the required roles`}),_jsx(_components.td,{children:`Running automations in GDAP clients`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Admin consent`}),_jsx(_components.td,{children:`The client’s Microsoft admin`}),_jsx(_components.td,{children:`Application Administrator in the client tenant`}),_jsx(_components.td,{children:`Each direct client`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`MSP tenant and staging`}),_jsx(_components.td,{children:`Admin`}),_jsx(_components.td,{children:`Application Administrator in the target tenant`}),_jsx(_components.td,{children:`Internal automation and testing`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-gdap-clients`,children:`Connect GDAP clients`}),`\n`,_jsx(Heading,{level:`3`,id:`step-1-connect-partner-center-admin`,children:`Step 1: Connect Partner Center (admin)`}),`\n`,_jsx(_components.p,{children:`Connecting Partner Center lets Automagically discover the clients you manage through GDAP and authorize itself in them.`}),`\n`,_jsxs(_components.p,{children:[`You need an account that is an `,_jsx(_components.strong,{children:`Admin Agent`}),` in Partner Center and holds `,_jsx(_components.strong,{children:`Application Administrator`}),` (or higher) in Entra ID. You can remove Application Administrator from the account once the connection is made. It’s only needed again if you reconnect.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Use a dedicated service account where possible. The connection is tied to the account that made it. If that account’s password changes, its MFA is reset or it’s disabled, Partner Center shows `,_jsx(_components.strong,{children:`Reconnect needed`}),` until someone signs in again.`]})}),`\n`,_jsx(_components.p,{children:`The account must belong to your own partner tenant:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`It must be a `,_jsx(_components.strong,{children:`member`}),` of the tenant, not a guest.`]}),`\n`,_jsx(_components.li,{children:`It doesn’t have to be your Thread login. A separate privileged admin account works.`}),`\n`,_jsx(_components.li,{children:`Your Thread login’s email domain must be a verified domain in that tenant, and your Thread email must exist as a user there.`}),`\n`,_jsx(_components.li,{children:`If your Partner Center is in a different tenant from your email domain, contact Thread support before you connect.`}),`\n`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the Microsoft 365 connect flow`,children:_jsxs(_components.p,{children:[`In Automagically, go to `,_jsx(_components.strong,{children:`Integrations`}),`. On the Microsoft 365 card, open `,_jsx(_components.strong,{children:`Connect clients`}),`, then click `,_jsx(_components.strong,{children:`Connect with GDAP`}),`. (During onboarding, the same option is on the clients step.)`]})}),_jsx(Step,{title:`Connect Partner Center`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Connect Partner Center`}),` and sign in with your partner tenant account. Complete MFA: Microsoft requires it for Partner Center.`]})}),_jsx(Step,{title:`Approve the permissions`,children:_jsx(_components.p,{children:`Approve the permissions listed below.`})})]}),`\n`,_jsxs(_components.p,{children:[`Automagically checks the account belongs to your partner tenant. Partner Center then appears on the Microsoft 365 card as `,_jsx(_components.strong,{children:`Connected`}),`, and the wizard lists your GDAP tenants.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Permission`}),_jsx(_components.th,{children:`Why Automagically needs it`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`DelegatedAdminRelationship.Read.All`})}),_jsx(_components.td,{children:`Reads your GDAP relationships, to discover your clients and check their roles.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Partner Center user_impersonation`})}),_jsx(_components.td,{children:`Authorizes your GDAP app in your clients through Partner Center.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`User.Read`}),`, `,_jsx(_components.code,{children:`User.ReadWrite.All`})]}),_jsx(_components.td,{children:`Confirm which tenant the signing-in account belongs to.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`openid`}),`, `,_jsx(_components.code,{children:`profile`}),`, `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`offline_access`})]}),_jsx(_components.td,{children:`Identify the signed-in admin and keep the connection alive.`})]})]})]}),`\n`,_jsx(Accordion,{title:`Why does Partner Center need User.ReadWrite.All?`,id:`why-does-partner-center-need-user-readwrite-all`,children:_jsx(_components.p,{children:`When you connect, Automagically checks that the account belongs to your own partner tenant and that your Thread email is a user there. That protects you from someone connecting your Partner Center to a different Thread workspace. Microsoft accepts this permission for the user lookup, and the Automagically app already holds it, so the connection asks for nothing new. Automagically only reads with it during the connect.`})}),`\n`,_jsx(Heading,{level:`3`,id:`step-2-set-up-your-gdap-app-admin`,children:`Step 2: Set up your GDAP app (admin)`}),`\n`,_jsxs(_components.p,{children:[`Microsoft only lets a partner authorize an app in its customers through Partner Center when the partner owns the app. So Automagically creates a copy of its app in your own tenant, owned by you, called `,_jsx(_components.strong,{children:`Automagically - M365 GDAP`}),`. All GDAP work runs as this app.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Two apps, one product.`}),` `,_jsx(_components.em,{children:`Automagically - M365`}),` (Thread’s app) is used for direct clients and your MSP and staging tenants. `,_jsx(_components.em,{children:`Automagically - M365 GDAP`}),` (your copy, with the same permissions) is used for your GDAP clients. You’ll see both in your Entra tenant.`]})}),`\n`,_jsxs(_components.p,{children:[`You need `,_jsx(_components.strong,{children:`Cloud Application Administrator`}),` or higher (for example Application Administrator or Global Administrator) in your own tenant. Partner Center must be connected first.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Start the GDAP app setup`,children:_jsxs(_components.p,{children:[`On the Microsoft 365 card, click `,_jsx(_components.strong,{children:`Set up`}),` on the `,_jsx(_components.strong,{children:`GDAP app`}),` row.`]})}),_jsx(Step,{title:`Approve two temporary permissions`,children:_jsxs(_components.p,{children:[`Sign in to the same tenant you connected Partner Center with, and approve two temporary permissions for Thread’s app: `,_jsx(_components.code,{children:`Application.ReadWrite.All`}),` (to create your app) and `,_jsx(_components.code,{children:`DelegatedPermissionGrant.ReadWrite.All`}),` (to remove both permissions again afterwards).`]})}),_jsx(Step,{title:`Automagically creates your app`,children:_jsxs(_components.p,{children:[`Automagically creates `,_jsx(_components.strong,{children:`Automagically - M365 GDAP`}),` with its own certificate, and removes the two temporary permissions from Thread’s app straight away.`]})}),_jsx(Step,{title:`Grant consent for the new app`,children:_jsxs(_components.p,{children:[`These are the same Microsoft Graph, Exchange and SharePoint permissions the Automagically app already uses. Until you do, the row shows `,_jsx(_components.strong,{children:`Consent pending`}),`.`]})}),_jsx(Step,{title:`Connect Partner Center again, as the new app`,children:_jsxs(_components.p,{children:[`Until you do, the row shows `,_jsx(_components.strong,{children:`Partner Center pending`}),`. The row then shows `,_jsx(_components.strong,{children:`Active`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`The flow takes about a minute. A sign-in from any tenant other than your Partner Center tenant is refused.`}),`\n`,_jsx(_components.p,{children:`When the app becomes active:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Every GDAP client you’ve already mapped is authorized automatically.`}),`\n`,_jsxs(_components.li,{children:[`Each technician reconnects `,_jsx(_components.strong,{children:`Your Microsoft sign-in`}),` once, because their earlier sign-in was made with Thread’s app.`]}),`\n`,_jsx(_components.li,{children:`Direct clients aren’t affected.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The app’s certificate lasts 2 years. The row shows `,_jsx(_components.strong,{children:`Expires soon`}),` when it’s due. Contact Thread support to renew it.`]}),`\n`,_jsx(Heading,{level:`3`,id:`step-3-map-and-authorize-your-gdap-clients-admin`,children:`Step 3: Map and authorize your GDAP clients (admin)`}),`\n`,_jsxs(_components.p,{children:[`On the Microsoft 365 clients page, click `,_jsx(_components.strong,{children:`Connect with GDAP`}),` and map each client to its Microsoft tenant. Automagically then authorizes your GDAP app in that client through Partner Center, applies the app’s permissions and checks the client’s GDAP roles. The client’s admin doesn’t do anything.`]}),`\n`,_jsx(_components.p,{children:`Authorization also runs:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`For every mapped client, when your GDAP app becomes active.`}),`\n`,_jsxs(_components.li,{children:[`When you click `,_jsx(_components.strong,{children:`Authorize`}),` on a client.`]}),`\n`,_jsxs(_components.li,{children:[`For all clients, when you click `,_jsx(_components.strong,{children:`Authorize all GDAP clients`}),`. Tick `,_jsx(_components.strong,{children:`Also update clients authorized with an older permission list`}),` to bring older authorizations up to date.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each client needs an active GDAP relationship that grants `,_jsx(_components.strong,{children:`Cloud Application Administrator`}),`, `,_jsx(_components.strong,{children:`Application Administrator`}),` or `,_jsx(_components.strong,{children:`Global Administrator`}),` to a security group your Partner Center account is in.`]}),`\n`,_jsxs(_components.p,{children:[`Each GDAP client shows one of these statuses in the `,_jsx(_components.strong,{children:`Partner Center`}),` column of the clients table.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`What it means`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Authorizing`}),_jsx(_components.td,{children:`Authorization is running.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Authorized`}),_jsx(_components.td,{children:`The app is authorized with its current permissions.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Permissions out of date`}),_jsxs(_components.td,{children:[`The app is authorized with an older permission list. Run `,_jsx(_components.strong,{children:`Authorize all GDAP clients`}),` with the update option ticked.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Temporary failure`}),_jsx(_components.td,{children:`Partner Center was busy or unavailable. Automagically retries for up to about 90 minutes.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Update failed`}),_jsx(_components.td,{children:`Updating an earlier authorization failed. The earlier one still works. The client shows the reason and the fix.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Failed`}),_jsx(_components.td,{children:`Authorization couldn’t complete. The client shows the reason and the fix.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Not authorized`}),_jsx(_components.td,{children:`Authorization hasn’t run yet.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A client you `,_jsx(_components.strong,{children:`Disconnect`}),` stays disconnected until you click `,_jsx(_components.strong,{children:`Authorize`}),` on it. Discovering, mapping again or `,_jsx(_components.strong,{children:`Authorize all GDAP clients`}),` won’t reconnect it.`]}),`\n`,_jsx(Heading,{level:`3`,id:`step-4-each-technician-connects-their-microsoft-account`,children:`Step 4: Each technician connects their Microsoft account`}),`\n`,_jsx(_components.p,{children:`Every technician who runs automations in GDAP clients signs in once:`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open Your Microsoft sign-in`,children:_jsxs(_components.p,{children:[`In Automagically, go to `,_jsx(_components.strong,{children:`Integrations`}),` and find `,_jsx(_components.strong,{children:`Your Microsoft sign-in`}),` on the Microsoft 365 card. The row appears once your workspace has a GDAP client.`]})}),_jsx(Step,{title:`Connect your Microsoft account`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Connect`}),` and sign in with your own Microsoft work account: the one your Thread login uses, which holds your GDAP access.`]})}),_jsx(Step,{title:`Confirm the row shows Connected`,children:_jsxs(_components.p,{children:[`The row shows `,_jsx(_components.strong,{children:`Connected`}),`.`]})})]}),`\n`,_jsx(_components.p,{children:`When you run an automation in a GDAP client, Automagically asks Microsoft for access to that client on your behalf, and Microsoft only grants what your GDAP roles allow there.`}),`\n`,_jsxs(_components.p,{children:[`You stay connected from then on: Automagically refreshes idle Partner Center and technician sign-ins daily. If Microsoft stops accepting a sign-in, the row shows `,_jsx(_components.strong,{children:`Reconnect needed`}),` and why.`]}),`\n`,_jsx(Heading,{level:`4`,id:`required-gdap-roles`,children:`Required GDAP roles`}),`\n`,_jsxs(_components.p,{children:[`Automagically checks each GDAP client’s relationships for these roles. A client connects as long as it has at least one, and lists any that are missing. Automations that need a missing role fail in that client. A client with none of them shows `,_jsx(_components.strong,{children:`Failed`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Role`}),_jsx(_components.th,{children:`Why it’s needed`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Application Administrator`}),_jsx(_components.td,{children:`App registration and consent management.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Authentication Policy Administrator`}),_jsx(_components.td,{children:`Authentication methods and MFA policies.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Cloud Device Administrator`}),_jsx(_components.td,{children:`Device management in Entra ID.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Exchange Administrator`}),_jsx(_components.td,{children:`Mailbox and mail flow management.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Global Reader`}),_jsx(_components.td,{children:`Read-only access across all services for discovery.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Intune Administrator`}),_jsx(_components.td,{children:`Endpoint and device policy management.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Privileged Authentication Administrator`}),_jsx(_components.td,{children:`Reset passwords and manage authentication for all users.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Privileged Role Administrator`}),_jsx(_components.td,{children:`Manage role assignments in Entra ID.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Security Administrator`}),_jsx(_components.td,{children:`Security policies and incident management.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`SharePoint Administrator`}),_jsx(_components.td,{children:`SharePoint Online and OneDrive management.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Teams Administrator`}),_jsx(_components.td,{children:`Microsoft Teams configuration and policies.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`User Administrator`}),_jsx(_components.td,{children:`User lifecycle: creation, licensing, group membership.`})]})]})]}),`\n`,_jsx(_components.p,{children:`Technicians must be members of the GDAP security groups these roles are assigned to in Partner Center.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`When no technician sign-in is available.`}),` A run a technician starts in a GDAP client always uses that technician’s own sign-in, including runs a flow or automation makes on a technician’s behalf. If Automagically can’t use it, for example because it needs reconnecting or was never connected, the run stops and asks the technician to connect `,_jsx(_components.strong,{children:`Your Microsoft sign-in`}),`. It never falls back to the Automagically app’s own permissions. The only exception is an intent run the Triage Agent starts with no technician behind it: it can use application permissions when the client’s own admin has also consented the Automagically app directly. Those operations aren’t recorded under a technician.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`connect-direct-clients`,children:`Connect direct clients`}),`\n`,_jsx(_components.p,{children:`For clients you don’t manage through GDAP, the client’s Microsoft admin approves the Automagically app once. They don’t need a Thread account.`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Find the client`,children:_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Microsoft 365 clients`}),` and find the client.`]})}),_jsx(Step,{title:`Share the consent link`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Copy link`}),` and send it to the client’s Microsoft admin (Application Administrator or higher), or click `,_jsx(_components.strong,{children:`Connect`}),` to complete it yourself if you’re an admin in their tenant.`]})}),_jsx(Step,{title:`Admin approves the permissions`,children:_jsx(_components.p,{children:`The admin signs in and approves the permissions. The client then shows as connected.`})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Sign in as the right admin.`}),` Microsoft reuses whichever account your browser is already signed in to. If the consent comes back with your staging tenant, or a tenant another of your clients already uses, Automagically refuses it and saves nothing. Open the link in a private window, or send it to the client’s admin.`]})}),`\n`,_jsxs(_components.p,{children:[`The consent covers everything Automagically can automate in that one tenant: users and groups, sign-in and MFA, mail and Exchange, Teams, SharePoint and OneDrive, Intune devices and security policy. See `,_jsx(_components.a,{href:`#what-the-permissions-are-for`,children:`What the permissions are for`}),` below for the full list.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`DAP clients.`}),` Partner Center also discovers clients you still manage through DAP, the older Delegated Admin Privileges. They connect with admin consent, like direct clients. Microsoft recommends moving them to GDAP.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-permissions-are-for`,children:`What the permissions are for`}),`\n`,_jsxs(_components.p,{children:[`When a client’s admin approves `,_jsx(_components.strong,{children:`Automagically - M365`}),`, or you grant consent for `,_jsx(_components.strong,{children:`Automagically - M365 GDAP`}),`, Microsoft shows a long list of permissions. It’s long for three reasons.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Most permissions appear twice.`}),` The first half of the list is application permissions, worded like “…in all mailboxes” or “…all site collections”. Automagically uses them for direct clients, your MSP tenant and your staging tenant. The second half is the matching delegated permissions, worded like “…user mail” or “Send mail as a user”. Automagically uses them in GDAP clients, where it acts as the signed-in technician and can’t do more than that technician’s GDAP roles allow.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`One consent covers every runbook.`}),` Consent is given once per tenant, not once per runbook, so the app asks for what every supported runbook might need. What actually runs is still controlled by runbook approval, Automagically roles, and (in GDAP clients) each technician’s GDAP roles.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Some areas use more than one Microsoft API.`}),` “Have full control of all site collections” appears four times because it’s granted in both Microsoft Graph and SharePoint, each as an application and a delegated permission. The “Manage Exchange…” permissions come from Exchange Online, because tasks like mail forwarding, shared mailboxes and mailbox permissions aren’t available in Microsoft Graph.`]}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Area`}),_jsx(_components.th,{children:`Permissions you’ll see`}),_jsx(_components.th,{children:`Why Automagically needs them`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Partner and GDAP`}),_jsx(_components.td,{children:`Read Delegated Admin relationships with customers`}),_jsx(_components.td,{children:`Discover your GDAP clients and check which roles each relationship grants.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tenant basics`}),_jsx(_components.td,{children:`Read organization information, Sign in and read user profile, Read all usage reports, Read all audit log data`}),_jsx(_components.td,{children:`Identify the tenant, read licence and usage data, and check what a run changed.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Users and groups`}),_jsx(_components.td,{children:`Read and write directory data, Read and write all users’ full profiles, Read and write all groups`}),_jsx(_components.td,{children:`Onboarding and offboarding, licensing and group membership.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Admin roles`}),_jsx(_components.td,{children:`Read and write all directory RBAC settings`}),_jsx(_components.td,{children:`Runbooks that change role assignments. During setup, Automagically also uses it to give its own app the Exchange Administrator role, which Microsoft requires before an app can run Exchange tasks.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Sign-in and MFA`}),_jsx(_components.td,{children:`Read and write all password profiles and reset user passwords, Read and write all users’ authentication methods, Read all users’ password authentication methods`}),_jsx(_components.td,{children:`Password resets, MFA registration and reset, and recovering a user who lost their device.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Security`}),_jsx(_components.td,{children:`Read and write your organization’s conditional access policies, Read your organization’s policies, Read and write all risky user information, Read all security alerts, Read your organization’s security events`}),_jsx(_components.td,{children:`Conditional Access changes, confirming or dismissing risky users, and triaging security alerts.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Mail and calendar`}),_jsx(_components.td,{children:`Read and write mail in all mailboxes, Send mail as any user, Read and write all user mailbox settings, Read and write calendars in all mailboxes`}),_jsx(_components.td,{children:`Out-of-office replies, delegate access, mail cleanup and calendar permissions.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Exchange`}),_jsx(_components.td,{children:`Manage Exchange As Application, Manage Exchange as application v2, Manage Exchange configuration`}),_jsx(_components.td,{children:`Exchange tasks that Microsoft Graph can’t do: mail forwarding, shared mailboxes, mailbox permissions and mail flow rules.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Teams`}),_jsx(_components.td,{children:`Create channels, Read the members of all channels, Add and remove members from all channels`}),_jsx(_components.td,{children:`Team and channel setup, and membership changes during onboarding and offboarding.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`SharePoint and OneDrive`}),_jsx(_components.td,{children:`Have full control of all site collections, Read items in all site collections, Read and write files in all site collections`}),_jsx(_components.td,{children:`Site permissions, external sharing, and handing over a leaver’s OneDrive.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Intune`}),_jsx(_components.td,{children:`Read and write Microsoft Intune devices`}),_jsx(_components.td,{children:`Device lookups, sync, retire and wipe.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-your-staging-tenant`,children:`Connect your staging tenant`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Staging tenant:`}),` on the Microsoft 365 card, click `,_jsx(_components.strong,{children:`Connect staging tenant`}),` to link a test tenant and try runbooks before they reach real clients. You can finish setup with only a staging tenant and connect clients later.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Partner Center connect says the account is a guest`}),_jsx(_components.td,{children:`You signed in with a guest account in your partner tenant`}),_jsxs(_components.td,{children:[`Sign in with an account that’s a `,_jsx(_components.strong,{children:`member`}),` of your own partner tenant.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Partner Center connect says your tenant hasn’t verified your Thread email’s domain`}),_jsx(_components.td,{children:`You signed in to a different tenant, or your Partner Center is in a separate tenant from your email domain`}),_jsx(_components.td,{children:`Sign in to the tenant that owns your email domain with its Admin Agent account. If your Partner Center really is in a separate tenant, contact Thread support.`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[`Partner Center or `,_jsx(_components.strong,{children:`Your Microsoft sign-in`}),` shows `,_jsx(_components.strong,{children:`Reconnect needed`})]}),_jsx(_components.td,{children:`Microsoft ended the sign-in (for example after a password change), now requires MFA, or a Conditional Access policy blocked it`}),_jsxs(_components.td,{children:[`Click `,_jsx(_components.strong,{children:`Reconnect`}),`, sign in again and complete MFA.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A GDAP client fails with “no role that can authorize the app”`}),_jsx(_components.td,{children:`No active GDAP relationship grants Cloud Application Administrator, Application Administrator or Global Administrator`}),_jsxs(_components.td,{children:[`Add one of those roles to an active GDAP relationship and click `,_jsx(_components.strong,{children:`Authorize`}),`, or connect the client directly.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A GDAP client fails because of Conditional Access`}),_jsx(_components.td,{children:`The client’s Conditional Access policies block your partner sign-ins`}),_jsx(_components.td,{children:`Ask the client’s admin to exclude your partner sign-ins from the policy.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`A GDAP client lists missing roles`}),_jsx(_components.td,{children:`Its GDAP relationship doesn’t grant every required role`}),_jsx(_components.td,{children:`Automations that need those roles fail in that client. Add the roles to a GDAP relationship.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Direct consent says the tenant is already connected to another client`}),_jsx(_components.td,{children:`Your browser was signed in as another admin, so Microsoft returned the wrong tenant`}),_jsx(_components.td,{children:`Open the link in a private window and sign in as the client’s admin. If the client really shares that tenant with another client, first add a contact on one of the tenant’s email domains to the client.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Automations work for one technician but not another`}),_jsxs(_components.td,{children:[`That technician hasn’t connected `,_jsx(_components.strong,{children:`Your Microsoft sign-in`}),`, or isn’t in the right GDAP security groups`]}),_jsx(_components.td,{children:`Have them connect their Microsoft account (Step 4) and check their GDAP group membership.`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Do my clients need to do anything?`,id:`do-my-clients-need-to-do-anything`,children:_jsx(_components.p,{children:`GDAP clients: no, Automagically is authorized through Partner Center. Direct clients: their Microsoft admin approves a consent link once. Neither needs a Thread account.`})}),_jsx(Accordion,{title:`Can I connect Partner Center with a separate admin account?`,id:`can-i-connect-partner-center-with-a-separate-admin-account`,children:_jsx(_components.p,{children:`Yes, as long as it’s a member (not a guest) of your own partner tenant and your Thread email is a user in that tenant.`})}),_jsx(Accordion,{title:`What happens when a technician leaves?`,id:`what-happens-when-a-technician-leaves`,children:_jsx(_components.p,{children:`Their sign-in stops working once their Microsoft account is disabled. Nothing shared is affected, and other technicians carry on with their own accounts.`})}),_jsx(Accordion,{title:`Can I have both GDAP and direct clients?`,id:`can-i-have-both-gdap-and-direct-clients`,children:_jsx(_components.p,{children:`Yes. To move a client that’s working on a direct connection to GDAP, map it over GDAP. Automagically asks you to confirm first, because it changes how that client connects.`})}),_jsx(Accordion,{title:`What is CPV, and why doesn't Automagically need it?`,id:`what-is-cpv-and-why-doesnt-automagically-need-it`,children:_jsx(_components.p,{children:`Control Panel Vendor (CPV) is a Microsoft program that lets a vendor’s app be authorized in partners’ customers. Automagically creates a copy of its app that you own instead, and Microsoft lets partners authorize their own apps in their customers, so no CPV enrollment is needed.`})}),_jsx(Accordion,{title:`Is authorization per client or global?`,id:`is-authorization-per-client-or-global`,children:_jsx(_components.p,{children:`Per client. Each tenant is authorized independently, so you control which tenants Automagically can access.`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect Microsoft 365 clients","sidebarTitle":"Connect Microsoft 365 clients","description":"Connect Automagically to your clients' Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.","boost":3,"href":"/automagically/connect-microsoft-365-clients"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you get","slug":"what-you-get","depth":2,"children":[]},{"title":"How the connection works (read this first)","slug":"how-the-connection-works-read-this-first","depth":2,"children":[]},{"title":"Connect GDAP clients","slug":"connect-gdap-clients","depth":2,"children":[{"title":"Step 1: Connect Partner Center (admin)","slug":"step-1-connect-partner-center-admin","depth":3,"children":[]},{"title":"Step 2: Set up your GDAP app (admin)","slug":"step-2-set-up-your-gdap-app-admin","depth":3,"children":[]},{"title":"Step 3: Map and authorize your GDAP clients (admin)","slug":"step-3-map-and-authorize-your-gdap-clients-admin","depth":3,"children":[]},{"title":"Step 4: Each technician connects their Microsoft account","slug":"step-4-each-technician-connects-their-microsoft-account","depth":3,"children":[]},{"title":"Required GDAP roles","slug":"required-gdap-roles","depth":4,"children":[]}]},{"title":"Connect direct clients","slug":"connect-direct-clients","depth":2,"children":[]},{"title":"What the permissions are for","slug":"what-the-permissions-are-for","depth":2,"children":[]},{"title":"Connect your staging tenant","slug":"connect-your-staging-tenant","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/thread/e9e74bb66602d208/skill-nav-scroll.js"],"subdomain":"thread","siteName":"Thread Docs","title":"Connect Microsoft 365 clients - Thread Docs","relatedPagesConfig":{"enabled":true,"limit":3,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6afb8234efa50aaaa5bdb18e","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"How do I connect GDAP clients?","status":"active","generatedBy":"contextual","path":"automagically/connect-microsoft-365-clients","createdAt":"2026-11-16T22:22:44.323Z","updatedAt":"2026-11-16T22:22:44.323Z","__v":0},{"_id":"6afb8234efa50aaaa5bdb18f","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"What's the difference between layers?","status":"active","generatedBy":"contextual","path":"automagically/connect-microsoft-365-clients","createdAt":"2026-11-16T22:22:44.323Z","updatedAt":"2026-11-16T22:22:44.323Z","__v":0},{"_id":"6afb8234efa50aaaa5bdb190","deploymentId":"6920f01f9d8412afd5a0dff5","questionText":"How do technicians get access?","status":"active","generatedBy":"contextual","path":"automagically/connect-microsoft-365-clients","createdAt":"2026-11-16T22:22:44.323Z","updatedAt":"2026-11-16T22:22:44.323Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T22:22:37.361Z","originalFileLocation":"automagically/connect-microsoft-365-clients.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Automagically to your clients\u0026#x27; Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Thread Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Microsoft 365 clients - Thread Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Automagically to your clients\u0026#x27; Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Thread Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getthread.com/automagically/connect-microsoft-365-clients\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://thread.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Connect+Microsoft+365+clients\u0026amp;description=Connect+Automagically+to+your+clients%27+Microsoft+365+tenants%3A+set+up+Partner+Center+and+your+GDAP+app%2C+connect+direct+clients%2C+and+fix+common+problems.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=89cfa9dbdef28495ddfa164b07ea59edf91ce5c30e2b9ca5f591ca00cdce5a0b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect Microsoft 365 clients - Thread Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Automagically to your clients\u0026#x27; Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://thread.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Connect+Microsoft+365+clients\u0026amp;description=Connect+Automagically+to+your+clients%27+Microsoft+365+tenants%3A+set+up+Partner+Center+and+your+GDAP+app%2C+connect+direct+clients%2C+and+fix+common+problems.\u0026amp;theme=f724fa3ec041ff897ae11da2\u0026amp;signature=89cfa9dbdef28495ddfa164b07ea59edf91ce5c30e2b9ca5f591ca00cdce5a0b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/thread/FC7ab3_wzYydgHyM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Thread Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00B398\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getthread.com/automagically/connect-microsoft-365-clients\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/automagically/connect-microsoft-365-clients.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getthread.com/#organization\",\"name\":\"Thread Docs\",\"url\":\"https://docs.getthread.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/thread/50guKpC0vegpyObR/logo/thread.svg?fit=max\u0026auto=format\u0026n=50guKpC0vegpyObR\u0026q=85\u0026s=86145b5e0fe1e4b555128fc8d8fd9815\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getthread.com#website\",\"name\":\"Thread Docs\",\"url\":\"https://docs.getthread.com\",\"publisher\":{\"@id\":\"https://docs.getthread.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients#webpage\",\"url\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients\",\"name\":\"Connect Microsoft 365 clients\",\"description\":\"Connect Automagically to your clients' Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\",\"dateModified\":\"2026-11-16T22:22:37.361Z\",\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Automagically\",\"item\":\"https://docs.getthread.com/automagically/automagically-getting-started\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get started\",\"item\":\"https://docs.getthread.com/automagically/automagically-getting-started\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Connect Microsoft 365 clients\",\"item\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients#article\",\"headline\":\"Connect Microsoft 365 clients\",\"name\":\"Connect Microsoft 365 clients\",\"description\":\"Connect Automagically to your clients' Microsoft 365 tenants: set up Partner Center and your GDAP app, connect direct clients, and fix common problems.\",\"url\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getthread.com/automagically/connect-microsoft-365-clients#webpage\"},\"dateModified\":\"2026-11-16T22:22:37.361Z\",\"publisher\":{\"@id\":\"https://docs.getthread.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getthread.com#website\"}}]}\u003c/script>","agentPointerHref":"/automagically/connect-microsoft-365-clients.md","siteName":"Thread Docs","nav":{"global":null,"tabs":[{"tab":"Start here","icon":"compass","pages":[{"title":"Start here","href":""}]},{"tab":"Onboarding","icon":"graduation-cap","hidden":true,"pages":[{"title":"Onboarding","href":"/onboarding/overview"}]},{"tab":"By role","icon":"users","pages":[{"title":"By role","href":"/start-here/roles/overview"}]},{"tab":"Guides","icon":"book-open","groups":[{"group":"Overview","icon":"book-open","root":{"title":"Product guides","sidebarTitle":"Overview","href":"/guides/overview"},"pages":[]},{"group":"Integrations","icon":"plug","pages":[{"group":"ConnectWise PSA","pages":[{"title":"Set Up the ConnectWise PSA Ticketing Integration","href":"/integrations/creating-a-connect-wise-manage-api-user"},{"title":"Add Thread Pods to ConnectWise Service Tickets","href":"/integrations/how-to-enable-a-pod"},{"title":"Quiet customer emails on a ConnectWise board","href":"/integrations/quiet-customer-emails-on-a-connectwise-board"}]},{"group":"Autotask PSA","pages":[{"title":"Set Up the Autotask PSA Ticketing Integration","href":"/integrations/creating-a-autotask-api-user"},{"title":"Enable Thread Chat \u0026 TimePad Insights in Autotask","href":"/integrations/how-to-enable-chat-and-timepad-insights-in-autotask"},{"title":"Install the Thread for Autotask Chrome extension","href":"/integrations/thread-for-autotask-chrome-extension"},{"title":"Configure Autotask Email Workflow for Thread","href":"/integrations/setting-up-an-email-communication-workflow-in-autotask"},{"title":"Turn off Autotask time entry summary note notifications","href":"/integrations/turn-off-autotask-time-entry-summary-note-notifications"}]},{"group":"Halo PSA","pages":[{"title":"Set Up the HaloPSA Ticketing Integration","href":"/integrations/how-to-setup-halo-psa-integration"},{"title":"Configure HaloPSA Action Mapping for Thread","href":"/integrations/action-mapping-configuration-with-thread"},{"title":"HaloPSA Chat Response Options for Thread","href":"/integrations/halo-response-options"},{"title":"HaloPSA Integration FAQ and Troubleshooting","href":"/integrations/halo-faq"},{"title":"Adding and Removing Contacts in Inbox (HaloPSA)","href":"/inbox/adding-removing-contacts-in-halo-psa"}]},{"group":"PSA Settings","pages":[{"title":"Sync Thread Members with Your PSA Automatically","href":"/integrations/keep-members-in-sync-with-psa-toggle"},{"title":"Log emoji reactions in PSA","href":"/integrations/log-emoji-reactions-in-psa"},{"title":"Manage PSA Board Visibility and Exclusions in Thread","href":"/integrations/managing-board-visibility-in-thread-board-exclusion"}]},{"group":"Other Integrations","pages":[{"title":"Connect Hudu Documentation to Super Magic","href":"/integrations/hudu-integration"},{"title":"Connect IT Glue Documentation to Super Magic","href":"/integrations/it-glue-super-magic"},{"title":"Automate PSA Scheduling with Microsoft Bookings","href":"/integrations/microsoft-bookings-integration-for-psa-scheduling"},{"title":"Connect Pia SmartForms to Thread Triage Agent","href":"/integrations/pia-integration"},{"title":"Connect Auvik Network Monitoring to Thread","href":"/integrations/auvik-integration"},{"title":"Connect CloudRadial to Thread for Client Chat","href":"/integrations/how-to-integrate-cloud-radial"},{"title":"Set Up the ConnectWise Automate Integration","href":"/integrations/how-do-i-set-up-connectwise-automate"},{"title":"Integrate TimeZest Scheduling with Thread Inbox","href":"/integrations/integrating-time-zest-with-thread"}]},{"group":"Push Knowledge Base Articles to IT Glue (beta)","hidden":true,"pages":[{"title":"Push Knowledge Base Articles to IT Glue","href":"/integrations/push-knowledge-base-articles-to-it-glue"}]}]},{"group":"Magic AI","icon":"wand-magic-sparkles","pages":[{"group":"Auto Prioritization","pages":[{"title":"Configure Magic Auto Prioritization","href":"/assistive-ai/how-to-set-up-auto-prioritization"}]},{"group":"Auto Categorization","pages":[{"title":"Configure Auto Categorization in Thread","href":"/assistive-ai/getting-started-with-auto-categorization"},{"title":"Configure Ticket Type Categorization in Autotask and Halo","href":"/assistive-ai/configuring-ticket-type-categorization"}]},{"group":"Auto Title","pages":[{"title":"Configure Magic Title in Thread","href":"/assistive-ai/setting-up-magic-title"},{"title":"Magic Title Rule Creation Guide","href":"/assistive-ai/magic-title-rule-creation-guide"}]},{"group":"Recap Templates","pages":[{"title":"Getting Started with Magic Recap","href":"/assistive-ai/magic-recap"},{"title":"Magic Recap Template Library","href":"/assistive-ai/magic-recap-template-library"}]},{"group":"Sentiment Analysis","pages":[{"title":"Configure Magic Sentiment","href":"/assistive-ai/configure-sentiment"},{"title":"Sentiment Flows, Escalations, and Recap Templates","href":"/assistive-ai/configure-automatic-escalations-and-recap-templates-for-sentiment-analysis"}]},{"group":"Magic AI reference","pages":[{"title":"Using Variables in Magic AI and Magic Agents","href":"/assistive-ai/variables"},{"title":"Best Practices for Writing Magic AI Prompts","href":"/assistive-ai/prompt-best-practices"},{"title":"Prompt engineering tips and tricks","href":"/assistive-ai/prompt-tips-and-tricks"},{"title":"Client Access and how AI runs on tickets","href":"/assistive-ai/client-access-and-run-paths"},{"title":"Magic AI FAQ","href":"/assistive-ai/faq"}]}]},{"group":"Magic Agents","icon":"robot","pages":[{"group":"About Magic Agents","pages":[{"title":"From Triage to Resolution: Agent-Driven Outcomes","href":"/ai-agents/agent-driven-resolutions"}]},{"group":"Triage Agent","pages":[{"title":"Getting Started with Triage Agent","href":"/ai-agents/getting-started-with-triage-agent"},{"title":"Triage Agent Setup User Guide","href":"/ai-agents/setting-up-your-triage-agent-user-guide"},{"title":"Create Your First Triage Agent Intents","href":"/ai-agents/create-your-first-intents"},{"title":"Build Your Magic Agents Service Catalog","href":"/ai-agents/building-your-magic-agents-service-catalog"},{"title":"Intent Creation Assistance Intent","href":"/ai-agents/intent-creation-assistance-intent"},{"title":"Triage Agent Custom Rules (Beta)","href":"/ai-agents/custom-rules-beta-partner-guide"},{"title":"Triage Agent Request Blocking for OOO and Noisy Requests","href":"/ai-agents/triage-agent-request-blocking-and-common-use-cases"},{"title":"Listening Mode for Triage Agents","href":"/ai-agents/listening-mode-for-triage-agents"},{"title":"Automate Approvals with Magic Agents","href":"/ai-agents/approvals"},{"title":"Set Up Email Support for Magic Agents and Inbox","href":"/ai-agents/setting-up-email-support-for-magic-agents"},{"title":"Triage Agent Settings","href":"/ai-agents/triage-agent-settings"},{"title":"Track Magic Agent Activity with a Workflow","href":"/ai-agents/creating-a-workflow-to-track-magic-agent-activity"},{"title":"Trigger Automations with the Triage Agent Automation URL","href":"/ai-agents/magic-agents-automation-url"}]},{"group":"Reminder Agent","pages":[{"title":"Configure Reminder Agent","href":"/ai-agents/reminder-agent"},{"title":"How Reminder Agent Works","href":"/ai-agents/reminder-agent-how-it-works"}]}]},{"group":"Voice AI","icon":"phone","pages":[{"group":"Set up Voice AI","pages":[{"title":"Create your first Voice AI agent","href":"/ai-agents/voice-ai-setup-phase-1-initial-configuration"},{"title":"Answer overflow \u0026 after-hours calls","href":"/ai-agents/voice-ai-setup-phase-2-overflow-after-hours"},{"title":"Replace your phone menu with the Auto-Attendant","href":"/ai-agents/voice-ai-setup-phase-3-the-auto-attendant-walk-run"}]},{"group":"Connect your phone system","pages":[{"title":"Forward your phone system to Voice AI","href":"/ai-agents/connect-your-phone-system-to-voice-ai"},{"title":"Phone system forwarding directory","href":"/ai-agents/phone-system-forwarding-directory"},{"title":"Connect your phone system to Voice AI with a SIP trunk","href":"/ai-agents/voice-ai-sip-trunks-and-caller-id"},{"title":"Connect 3CX to Voice AI with a SIP trunk","href":"/ai-agents/connect-3cx-to-voice-ai-with-a-sip-trunk"},{"title":"Add inbound to your existing Thread-3CX SIP trunk","href":"/ai-agents/add-inbound-to-your-3cx-sip-trunk"}]},{"group":"Tune agent behaviour","pages":[{"title":"Minimal vs Advanced AI mode","href":"/ai-agents/voice-ai-attendant-modes"},{"title":"Voice AI Contact Mapping","href":"/ai-agents/contact-mapping"},{"title":"Voice Shield: Safer Existing-Ticket Handling","href":"/ai-agents/voice-ai-voice-shield"},{"title":"Voice AI Pronunciation Guide","href":"/ai-agents/voice-ai-pronunciation-guide"}]},{"group":"Numbers \u0026 calling","pages":[{"title":"Voice AI Outbound Calling Setup","href":"/ai-agents/voice-ai-outbound-calling"},{"title":"Enable Teams Pay-As-You-Go Calling for Resource Accounts","href":"/ai-agents/microsoft-teams-pay-as-you-go-resource-account-calling"},{"title":"Call an on-call technician from a Flow","href":"/ai-agents/voice-ai-on-call-escalation"}]},{"group":"Troubleshoot","pages":[{"title":"Troubleshoot Voice AI","href":"/ai-agents/voice-ai-troubleshooting"},{"title":"Voice AI FAQ","href":"/ai-agents/voice-ai-faq"}]},{"group":"Changelog","pages":[{"title":"Voice AI updates 2026","sidebarTitle":"2026","href":"/ai-agents/voice-ai-changelog"},{"title":"Voice AI updates 2025","sidebarTitle":"2025","href":"/ai-agents/voice-ai-changelog-2025"}]}]},{"group":"Messenger","icon":"comments","pages":[{"group":"Messenger settings","pages":[{"title":"Messenger Settings: Configure Chat, Design, and Hours","href":"/inbox/messenger"},{"title":"Set Messenger to French","href":"/messenger/multi-language-support"}]},{"group":"Teams Service App","pages":[{"title":"Deploy the Teams Service App to a customer","href":"/messenger/deploy-the-teams-service-app"},{"title":"Design a Custom Teams App for Your Customers","href":"/messenger/create-teams-app"},{"title":"How to Roll Out the Teams Service App to Specific Users","href":"/messenger/how-to-roll-out-the-teams-service-app-to-specific-users"},{"title":"Enterprise Teams Support: Shared M365 Tenants","href":"/messenger/enterprise-teamssupport"},{"title":"How to Uninstall the Microsoft Teams Service App","href":"/messenger/how-to-uninstall-the-microsoft-teams-thread-service-app"},{"title":"Microsoft Teams 2.0 FAQs","href":"/messenger/microsoft-teams-2-0-faqs"},{"group":"Legacy","pages":[{"title":"Cloning a Legacy Teams App","href":"/messenger/cloning-a-legacy-teams-app"},{"title":"How to Upgrade your Legacy Teams App","href":"/messenger/how-to-upgrade-your-legacy-teams-app"}]}]},{"group":"Desktop Service App","pages":[{"title":"Deploy Messenger on Windows via command line","href":"/messenger/deploying-messenger-on-windows"},{"title":"Deploying Messenger to Mac","href":"/messenger/deploying-messenger-to-mac"},{"title":"How to Deploy Desktop Messenger with SSO","href":"/messenger/how-to-deploy-desktop-messenger-with-sso"},{"title":"Kiosk Mode","href":"/messenger/kiosk-mode"}]},{"group":"Web Service App","pages":[{"title":"Embedding Messenger on a Landing Page","href":"/messenger/embedding-messenger-on-landing-page"},{"title":"Messenger Portal Auto Authentication","href":"/messenger/messenger-identity-verification"},{"title":"Emoji reactions in Messenger","href":"/messenger/emoji-reactions"}]},{"group":"Slack Service App","pages":[{"title":"Deploy the Slack Service App to a customer","href":"/messenger/deploy-the-slack-service-app"}]},{"group":"Messenger FAQ","pages":[{"title":"How Configurations and Assets Work in Messenger Chat","href":"/messenger/configurations-in-messenger"}]},{"group":"Chat routing \u0026 entry points","pages":[{"title":"Add a Chat Now Button to PSA Ticket Emails","href":"/messenger/add-chat-now-button-email"},{"title":"Route chats to the right board","href":"/messenger/route-chats-to-the-right-board"},{"title":"Show All Tickets in Chat and Excluded Boards","href":"/messenger/show-all-tickets-in-chat-and-excluded-board-source"}]},{"group":"Client Portal (Beta)","hidden":true,"pages":[{"title":"Give a client's site contacts a Client Portal","href":"/messenger/client-portal-for-site-contacts"}]}]},{"group":"Thread Inbox","icon":"inbox","pages":[{"group":"Tour Inbox","pages":[{"title":"Inbox Navigation: Rail, Side Panel, and Views","href":"/inbox/inbox-navigation"},{"title":"Inside a View: Inbox vs. List Display Modes","href":"/inbox/inside-a-view"},{"title":"Navigating a Thread in Inbox","href":"/inbox/navigating-a-thread"},{"title":"CC People Who Aren't Contacts on a Ticket","href":"/inbox/cc-people-who-arent-contacts"},{"title":"Thread Control Panel: Contact, TimePad, and AI Insights","href":"/inbox/thread-control-panel"}]},{"group":"Set up teams \u0026 dispatch","pages":[{"title":"Set Up Thread Inbox by Service Team Structure","href":"/inbox/service-team-structure"},{"title":"Inbox Teams: Group Members and Share Views at Scale","href":"/inbox/inbox-teams"},{"title":"Views and Insights in Thread Inbox","href":"/inbox/views-and-insights"},{"title":"Set up XLA Profiles in Thread","href":"/inbox/sla-timers-and-response-settings"}]},{"group":"Work tickets","pages":[{"title":"Create an Email Signature Using Thread Snippets","hidden":true,"href":"/inbox/how-to-create-an-email-signature-using-snippets"},{"title":"Set Up a SmileBack CSAT Survey with Snippets","href":"/inbox/how-to-setup-a-csat-survey"},{"title":"Approvals in Inbox: Request and Manage Decisions","href":"/inbox/approvals-in-inbox"},{"title":"Configure Autotask UDFs for Thread Approvals","href":"/inbox/autotask-approval-configuration"},{"title":"Default Work Role and Type Logic in Time Entries","href":"/inbox/default-work-role-type-logic"},{"title":"Track your time with TimePad","href":"/inbox/track-your-time-with-timepad"}]},{"group":"Plan work","pages":[{"title":"Planner and Outlook Calendar Integration","href":"/inbox/planner-outlook-calendar-integration"},{"title":"Schedule work in Planner","href":"/inbox/using-planner"}]},{"group":"Business hours","pages":[{"title":"Business Hours, Holidays, and Custom Closures","href":"/inbox/holidays-and-custom-closures"}]},{"group":"Email channel (Beta)","hidden":true,"pages":[{"title":"Turn a Microsoft 365 mailbox into a ticket channel","href":"/inbox/turn-a-microsoft-365-mailbox-into-a-ticket-channel"}]},{"group":"What's new (Beta)","hidden":true,"pages":[{"title":"See what's new in Thread from Inbox and Admin Panel","href":"/inbox/see-whats-new-in-thread"}]},{"group":"Global search","pages":[{"title":"Global search","sidebarTitle":"Global search","icon":"magnifying-glass","href":"/inbox/global-search"},{"title":"Find a ticket by its ticket number in Inbox","href":"/inbox/find-a-ticket-by-its-number"}]},{"group":"Status colors","pages":[{"title":"Customize PSA status colors in Thread","href":"/inbox/customize-status-colors"}]}]},{"group":"Flows","icon":"diagram-project","pages":[{"group":"Flows","pages":[{"title":"Flows: Automate Thread Routing and Actions in Inbox","href":"/inbox/flows"},{"title":"Flows Audit Log: Review Every Run","sidebarTitle":"Flows Audit Log","href":"/inbox/flows-audit-log"},{"title":"See what an agent did during a flow run","href":"/inbox/see-what-a-super-magic-agent-did-during-a-flow-run"},{"title":"Status Automations: Auto-Update Thread Statuses","href":"/inbox/status-automations"}]},{"group":"Workflows (Beta)","hidden":true,"pages":[{"title":"Build an automation with Workflows in Thread Admin","href":"/inbox/build-automations-with-workflows"}]},{"group":"CSAT survey action (Beta)","hidden":true,"pages":[{"title":"Send a CSAT survey from a Flow","sidebarTitle":"Send CSAT survey action","href":"/inbox/send-a-csat-survey-from-a-flow"},{"title":"Crewhu CSAT Survey Integration","href":"/crewhu-csat-survey-integration"}]},{"group":"Thread CSAT surveys (Beta)","hidden":true,"pages":[{"title":"Send Thread's built-in CSAT survey when a ticket closes","sidebarTitle":"Thread CSAT surveys","href":"/inbox/send-thread-csat-surveys"}]},{"group":"CSAT ratings report (Beta)","hidden":true,"pages":[{"title":"Review and export CSAT ratings in Thread Admin","sidebarTitle":"CSAT ratings report","href":"/inbox/review-csat-ratings-in-thread-admin"}]},{"group":"Status mapping","pages":[{"title":"Configure Status Mapping in Thread","href":"/get-started/status-mapping-in-thread"}]}]},{"group":"Agent Builder","icon":"robot","pages":[{"title":"Build an agent with Agent Builder","href":"/super-magic/build-a-super-magic-agent"},{"title":"Chaining skills","href":"/super-magic/chaining-skills"}]},{"group":"Auto Dispatch","icon":"route","pages":[{"group":"Auto-Dispatch","hidden":false,"pages":[{"title":"Auto-Dispatch profiles","hidden":false,"href":"/inbox/auto-dispatch-profiles"},{"title":"Set your availability for Auto-Dispatch","hidden":false,"href":"/inbox/available-for-dispatch"},{"title":"Team Home for Auto-Dispatch","hidden":false,"href":"/inbox/team-home"},{"title":"Scheduling and work schedules for Auto-Dispatch","sidebarTitle":"Scheduling and work schedules","hidden":false,"href":"/inbox/scheduling-and-work-schedules"}]},{"group":"Work schedules (Beta)","pages":[{"title":"Create and manage work schedules","href":"/inbox/create-and-manage-work-schedules"}]},{"group":"Dispatch scenarios","pages":[{"title":"Tiered dispatch","href":"/inbox/dispatch-scenarios/tiered-dispatch-on-a-shared-board"},{"title":"Pod and client dispatch","href":"/inbox/dispatch-scenarios/pod-and-client-dispatch"},{"title":"Auto-assign plus an agent","href":"/inbox/dispatch-scenarios/auto-assign-plus-an-agent"},{"group":"Dispatch with agents","pages":[{"title":"Agent dispatch","href":"/inbox/dispatch-scenarios/agent-dispatch-on-a-shared-board"},{"title":"Skill-match dispatch","href":"/inbox/dispatch-scenarios/skill-match-dispatch"},{"title":"Triage, route, then dispatch","href":"/inbox/dispatch-scenarios/triage-route-then-dispatch"},{"title":"Tiered dispatch with agents","href":"/inbox/dispatch-scenarios/tiered-dispatch-with-agents"},{"title":"After-hours and shift dispatch","href":"/inbox/dispatch-scenarios/after-hours-and-shift-dispatch"},{"title":"Catch and re-dispatch tickets","href":"/inbox/dispatch-scenarios/catch-and-re-dispatch"},{"title":"Dispatch recommendations","href":"/inbox/dispatch-scenarios/dispatch-recommendations"}]}]}]},{"group":"Super Magic \u0026 Thread MCP","icon":"sparkles","pages":[{"group":"Using Super Magic","pages":[{"title":"Meet Super Magic: Your AI Agent in Inbox","href":"/super-magic/meet-super-magic-your-ai-assistant-in-the-inbox"},{"title":"How to use Super Magic skills","sidebarTitle":"How to use skills","href":"/super-magic/how-to-use-skills"},{"title":"Super Magic Admin Guide: Setup, Access \u0026 Safety","href":"/super-magic/super-magic-admin-guide-setup-access-safety"},{"title":"Proactive Suggestions in Super Magic","href":"/super-magic/proactive-suggestions"},{"title":"Share Super Magic chats with teammates","href":"/super-magic/share-super-magic-chats-with-teammates"},{"title":"Tag teammates in ticket notes with Super Magic","href":"/super-magic/tag-teammates-in-ticket-notes-with-super-magic"},{"title":"Connect Knowledge Sources to Super Magic","href":"/super-magic/connect-it-glue-hudu-time-zest-knowledge-sources-to-super-magic"},{"title":"Super Magic prompting 101","href":"/super-magic/prompting-101"},{"title":"Super Magic FAQ","href":"/super-magic/faq"}]},{"group":"Super Magic Tools","pages":[{"title":"Add External Tools to Super Magic with Connectors","href":"/super-magic/add-external-tools-to-super-magic-with-connectors-super-mcp"},{"title":"Add a custom MCP connector to Super Magic","href":"/super-magic/add-a-custom-mcp-connector-to-super-magic"},{"title":"Connect Halo MCP to Super Magic","href":"/super-magic/connect-halo-mcp-to-super-magic"},{"title":"Connect NinjaOne to Super Magic","href":"/super-magic/connecting-ninja-one-to-super-magic"},{"title":"Use Hudu with Super Magic","href":"/super-magic/use-hudu-with-super-magic"},{"title":"Use ImmyBot with Super Magic","href":"/super-magic/use-immybot-with-super-magic"},{"title":"Use IT Glue with Super Magic","href":"/super-magic/use-it-glue-with-super-magic"},{"title":"Use Linear with Super Magic","href":"/super-magic/use-linear-with-super-magic"},{"title":"Use Liongard with Super Magic","href":"/super-magic/use-liongard-with-super-magic"},{"title":"Use Notion with Super Magic","href":"/super-magic/use-notion-with-super-magic"},{"title":"Use TimeZest with Super Magic","href":"/super-magic/use-time-zest-with-super-magic"},{"title":"Use Zapier with Super Magic","href":"/super-magic/use-zapier-with-super-magic"},{"title":"Use Atlassian (Jira and Confluence) with Super Magic","href":"/super-magic/use-atlassian-with-super-magic"},{"title":"Use CIPP with Super Magic","href":"/super-magic/use-cipp-with-super-magic"},{"title":"Use Lexful with Super Magic (beta)","href":"/super-magic/use-lexful-with-super-magic"},{"title":"Use ClickUp with Super Magic","href":"/super-magic/use-clickup-with-super-magic"},{"title":"Use Cloudflare with Super Magic","href":"/super-magic/use-cloudflare-with-super-magic"},{"title":"Use monday.com with Super Magic","href":"/super-magic/use-monday-with-super-magic"},{"title":"Use Vanta with Super Magic","href":"/super-magic/use-vanta-with-super-magic"},{"title":"Use Trello with Super Magic","href":"/super-magic/use-trello-with-super-magic"},{"title":"Use ConnectWise RMM with Super Magic","href":"/super-magic/connect-connectwise-rmm"}]},{"group":"Thread MCP","pages":[{"title":"Thread MCP Server: Developer Guide","href":"/super-magic/thread-mcp-server-developer-guide"},{"title":"Control who can connect AI apps to Thread MCP","sidebarTitle":"Control who can connect AI apps","href":"/super-magic/control-who-can-connect-ai-apps-to-thread-mcp"},{"title":"Super Magic Tool Reference","href":"/super-magic/super-magic-tool-reference"}]},{"group":"MCP automation keys","hidden":false,"pages":[{"title":"Issue MCP automation keys for team members","href":"/super-magic/issue-mcp-automation-keys-for-team-members"}]},{"group":"Personal service agents (Beta)","hidden":true,"pages":[{"title":"Create a personal service agent in Super Magic","href":"/super-magic/create-a-personal-service-agent-in-super-magic"}]},{"group":"Auto mode (Beta)","hidden":true,"pages":[{"title":"Let Super Magic make changes without asking (Auto mode)","href":"/super-magic/let-super-magic-make-changes-without-asking-auto-mode"}]},{"group":"Developer reference","pages":[{"title":"Webhooks \u0026 APIs: How Thread Talks to Your PSA","href":"/get-started/webhooks-apis-how-thread-talks-to-your-psa"},{"title":"Trigger Rewst Workflows from Thread Magic Intents","href":"/integrations/thread-rewst-integration"}]}]},{"group":"Companion Apps","icon":"puzzle-piece","pages":[{"group":"Teams Companion App","pages":[{"title":"Install the Teams Companion App","href":"/companion-apps/install-the-teams-companion-app"}]},{"group":"Slack Companion App","pages":[{"title":"Install the Slack Companion App","href":"/companion-apps/install-the-slack-companion-app"},{"title":"How to Use the Slack Companion App for Service Teams","href":"/companion-apps/how-to-use-the-slack-companion-app-for-service-teams"}]},{"group":"Channel settings","pages":[{"title":"Choose which ticket updates post to a channel","href":"/companion-apps/choose-which-ticket-updates-post-to-channel"}]},{"group":"Super Magic in Companion Apps (Beta)","hidden":true,"pages":[{"title":"Use Super Magic in Microsoft Teams and Slack","href":"/companion-apps/use-super-magic-in-teams-and-slack"}]}]},{"group":"Service Intelligence","icon":"brain","pages":[{"group":"Contact Intelligence","pages":[{"title":"Contact Intelligence Overview","href":"/ai-agents/contact-intelligence"},{"title":"Contact Intelligence FAQ","href":"/ai-agents/contact-intelligence-faq"}]},{"group":"Knowledge Intelligence","pages":[{"title":"Getting Started with Client Intelligence","href":"/ai-agents/getting-started-with-knowledge"},{"title":"Client Intelligence Service Tech Guide","href":"/ai-agents/knowledge-intelligence-service-tech-guide"}]}]},{"group":"Magic Analytics","icon":"chart-line","pages":[{"group":"Get started","pages":[{"title":"Getting Started with Magic Analytics","href":"/analytics/getting-started-with-magic-analytics"},{"title":"Magic Analytics Topics You Can Explore","href":"/analytics/topics-you-can-explore"}]},{"group":"Dashboards","pages":[{"title":"ROI Value Realization Dashboard","href":"/analytics/roi-value-realization-dashboard"},{"title":"Assistive AI Accuracy Dashboard","href":"/analytics/assistive-ai-accuracy-dashboard"},{"title":"Triage Agent Summary Dashboard","href":"/analytics/triage-agent-dashboard"},{"title":"Voice AI Analytics dashboard","href":"/analytics/voice-ai-dashboard"},{"title":"Messenger Analytics Dashboard","href":"/analytics/messenger-analytics-dashboard"},{"title":"Service Team Performance \u0026 AI Usage Dashboard","href":"/analytics/service-team-performance-dashboard"},{"title":"Super Magic Usage Dashboard","href":"/analytics/super-magic-usage-dashboard"}]},{"group":"Work with your data","pages":[{"title":"Dashboard Agent: query Magic Analytics in plain English","href":"/analytics/dashboard-agent"},{"title":"Downloads, Alerts, and Scheduled Delivery","href":"/analytics/downloading-alerts-scheduling"}]},{"group":"Reference","pages":[{"title":"Magic Analytics: Things to Know and Gotchas","href":"/analytics/things-to-know-and-gotchas"},{"title":"Magic Analytics FAQs","href":"/analytics/faqs"}]}]},{"group":"Workspace administration","icon":"sliders","pages":[{"group":"Workspace \u0026 branding","pages":[{"title":"Workspace Defaults: Time Zone and TimePad Settings","href":"/inbox/workspace"},{"title":"Member and Contact Avatars in Inbox and Messenger","href":"/inbox/avatars"},{"title":"Dark mode and themes","sidebarTitle":"Dark mode and themes","href":"/inbox/dark-mode-and-themes"}]},{"group":"Members \u0026 access","pages":[{"title":"Managing Members in Thread Admin","href":"/inbox/members-management"},{"title":"Team Admin Role: Scoped Admin Permissions","href":"/inbox/team-admin-role"},{"title":"Restrict a member's access to specific clients","href":"/inbox/restrict-member-access-to-specific-clients"},{"title":"Set Up Single Sign-On (SSO) with Microsoft 365","href":"/inbox/how-to-setup-single-sign-on-sso"}]},{"group":"Clients","pages":[{"title":"Clients Tab: Managing Companies and Messenger Deployment","href":"/inbox/clients-tab"}]},{"group":"End-user verification","pages":[{"title":"Thread Verify","sidebarTitle":"Thread Verify","href":"/inbox/verify"}]}]},{"group":"Notifications","icon":"bell","pages":[{"group":"For your Team","pages":[{"title":"How Notifications Work for your Team","href":"/notifications/how-will-notifications-work-internally"},{"title":"How to Manage Your Inbox Notifications","href":"/notifications/managing-your-inbox-notifications"}]},{"group":"For your Customers","pages":[{"title":"How Notifications Work for your Customers","href":"/notifications/how-notifications-work-externally"}]}]},{"group":"Security \u0026 compliance","icon":"shield-halved","pages":[{"group":"Security reviews","pages":[{"title":"Thread Trust Center","href":"/security-billing/soc-2-and-compliance-status"}]},{"group":"Data \u0026 AI handling","pages":[{"title":"Data \u0026 Encryption","href":"/security-billing/data-encryption"},{"title":"Magic AI Privacy \u0026 Security Overview","href":"/security-billing/magic-ai-privacy-security"},{"title":"Claude on AWS Bedrock","href":"/security-billing/claude-on-aws-bedrock"},{"title":"Thread Sub-Processors List","href":"/security-billing/list-of-sub-processors"}]},{"group":"Network \u0026 app permissions","pages":[{"title":"Thread IP Addresses and Domains to Allowlist","href":"/security-billing/what-if-my-organization-has-ip-restrictions"},{"title":"Microsoft Teams App Permissions Reference","href":"/security-billing/microsoft-teams-app-permissions"},{"title":"Slack App Permissions Guide","href":"/security-billing/slack-permissions-guide"}]}]},{"group":"Plans \u0026 billing","icon":"credit-card","pages":[{"group":"Plans \u0026 licensing","pages":[{"title":"Access Your Thread Billing Portal","href":"/security-billing/how-to-access-your-thread-billing-portal"},{"title":"Plans and Licenses: AI and Chat License Management","href":"/inbox/plans-licenses"}]}]},{"group":"Automagically","icon":"wand-magic-sparkles","pages":[{"group":"Get started","pages":[{"title":"Automagically: Getting Started","sidebarTitle":"Getting started","href":"/automagically/automagically-getting-started"},{"group":"Running Runbooks","pages":[{"title":"Automagically: Running Runbooks","sidebarTitle":"Running Runbooks","href":"/automagically/automagically-running-runbooks"},{"title":"Running from Automagically","href":"/automagically/running-runbooks/running-from-automagically"},{"title":"Running from the ticket","href":"/automagically/running-runbooks/running-from-the-ticket"},{"title":"Running from Super Magic","href":"/automagically/running-runbooks/running-from-super-magic"},{"title":"Runbook Execution Results","href":"/automagically/running-runbooks/runbook-execution-results"}]},{"title":"Automagically: Approving Runbooks","sidebarTitle":"Approving Runbooks","href":"/automagically/automagically-approving-runbooks"},{"title":"Modifying a Runbook","sidebarTitle":"Modifying a Runbook","description":"Describe a change in plain English and Automagically plans, builds, and tests a new version of the runbook for your approval.","href":"/automagically/modifying-a-runbook"},{"title":"Connect Microsoft 365 clients","sidebarTitle":"Connect Microsoft 365 clients","href":"/automagically/connect-microsoft-365-clients"},{"title":"Automagically: Building a Runbook","sidebarTitle":"Building a Runbook","description":"Describe an IT task in plain English and Automagically plans, builds, tests, and prepares a runbook for your approval.","href":"/automagically/building-a-runbook"}]},{"group":"Configure","hidden":true,"pages":[{"title":"Automagically: Client Access","href":"/automagically/automagically-client-access"},{"title":"Managing Microsoft 365 client connections","href":"/automagically/automagically-microsoft-365-integrations"},{"title":"Microsoft 365 permissions reference","href":"/automagically/automagically-microsoft-365-permissions"}]},{"group":"Security \u0026 compliance","pages":[{"title":"Automagically security and compliance controls","href":"/automagically/automagically-security-controls"}]}]}]},{"tab":"Magic Library","icon":"https://mintlify.s3.us-west-1.amazonaws.com/thread/logo/stars.svg","pages":[{"title":"Magic Library","href":"/skill-library/overview"}]},{"tab":"Resources","icon":"folder-open","pages":[{"title":"Resources","href":"/events-and-resources"}]}]},"basePath":"","title":"Connect Microsoft 365 clients - Thread Docs","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BjdIPj1P.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}