For the complete documentation index, see llms.txt. This page is also available as Markdown.

1: Connect & Sync

Material automatically syncs new subdomains added to your Google Workspace or Microsoft 365 organization. No action is required in Material when you add a subdomain.

Connect Your First Email Tenant

To begin, connect your first email tenant so Material can begin detecting and creating issues.

spinner
Connect to Google Workspace
  1. Log in to Material with the Super Admin account we created for you when we set up your trial.

  2. Next, invite a new account to enroll the new tenant. This account needs to already have a Google Workspace Super Admin role, and will become the first account in the new tenant. Invite a new account

  3. From the workspace, click Explorer.

    workspace explorer accounts
  4. Click Accounts.

  5. On the top right, click Enroll Accounts.

  6. From the drop-down, choose Invite Account.

  7. From the drop-down, choose Super Admin or Tenant Enroller.

  8. Select Google, then enter the email address for the Google Workspace Super Admin account you're inviting.

  9. Click Get Invite Link.

  10. Copy the invite link, then share it with the Google Workspace Super Admin account associated with the email address entered above. (This can be you if you invited another one of your accounts.) No email invite is sent. If you need to resend the invite link, follow steps 1–8 again and send a new link.

    The new Google Workspace Super Admin account performs the remaining steps below:

  11. Open an incognito browser window to avoid session conflicts.

  12. Log in as the new Super Admin/Tenant Enroller via the invite link you sent (or received) in step 8 above.

  13. From the left navigation, expand Explorer, then click Accounts.

  14. On the top right, click Enroll Accounts.

  15. Click Enroll Google Workspace Tenant.

  16. The steps to complete enrollment, including links to the Google Workspace destinations, appear. Follow those steps to complete the connection using the same new account you just used to log in to Material.

    Instructions in app
Connect to Microsoft 365
  1. Log in to Material with a Super Admin account.

  2. Next, invite a new account to enroll the new tenant. This account needs to already have the Microsoft 365 Global Administrator role, and will become the first account in the new tenant:

Invite a new account

  1. From the workspace, click Explorer.

  2. Click Accounts.

  3. On the top right, click Enroll Accounts.

  4. From the drop-down, choose Invite Account.

  5. From the drop-down, choose Super Admin or Tenant Enroller.

  6. Select Microsoft, then enter the email address for the Microsoft 365 Global Administrator account you're inviting.

    1. Click Get Invite Link.

    2. Copy the invite link, then share it with the Microsoft 365 Global Administrator account associated with the email address entered above. (This can be you if you invited another one of your accounts.) No email invite is sent. If you need to resend the invite link, follow steps 1–6 again and send a new link.

The new Microsoft 365 Global Administrator account performs the remaining steps below:

  1. Open an incognito browser window to avoid session conflicts.

  2. Log in as the new Super Admin/Tenant Enroller via the invite link you sent (or received) in step 6 above.

  3. From the left navigation, expand Explorer, then click Accounts.

  4. On the top right, click Enroll Accounts.

  5. Click Enroll Microsoft 365 Tenant.

  6. The steps to complete enrollment appear. Follow those steps to complete the connection using the same new account you just used to log in to Material.

Tenants on the same shared instance will have the same Material URLs. The account (Google or Microsoft) you are logged in as determines the tenant you can access.


spinner

Default Account Settings

After you've connected an email tenant, you need to enable a few things to allow Material to sync messages and files from an account's mailbox.

From the top toolbar, click Settings > Default Account Settings.

Syncing

  1. Toggle Email Sync to On.

  1. Toggle File Sync to On.


Google Drive Security Settings

For Google Workspace tenants:

  1. From the top toolbar, confirm you're on a Google Tenant. (If you only have one tenant synced, you'll only see Global).

  2. From the left navigation, expand Google Drive Security, then click Settings.

  3. Toggle Connect to Google Drive to On.

How to enable or disable syncing for an individual account or group:
  1. From the workspace, click Explorer.

  2. Click Accounts or Groups.

  3. Open an account or group, then click the Settings tab.

  4. Under Syncing, select Override for the setting you want to change, then toggle the option and save.

To bulk update settings, select multiple accounts/groups, then from the bottom toolbar, click Edit Settings:

Last updated

Was this helpful?