IT SETUP · MICROSOFT 365

Microsoft 365 integrations

Approve the Argos Microsoft application used to connect Outlook and SharePoint in centrally managed tenants.

Argos uses one multitenant Microsoft application for its Outlook and SharePoint integrations. In organizations that restrict user consent, a Microsoft Entra administrator must grant consent before individual users can connect either integration.

Separate application

This application is separate from your organization-specific WorkOS SSO application. Do not add Outlook or SharePoint permissions to the SSO application, and do not use the Microsoft integration application for login or SCIM.

Argos application details

DetailValue
PurposeOutlook and SharePoint integrations
Application typeArgos-owned multitenant Microsoft Entra application
Application (client) ID3d61dce1-e589-49f7-bbd6-92512e891896

The client ID is a public application identifier. Argos does not provide customers with the application's client secret.

Grant administrator consent

  1. 01

    Copy your tenant ID

    In the Microsoft Entra admin center, open Identity → Overview and copy the Tenant ID for the organization where users will connect Outlook or SharePoint.

  2. 02

    Build the administrator consent URL

    Replace <YOUR_TENANT_ID> in the URL below with your tenant ID. Keep the Argos client ID unchanged.

    https://login.microsoftonline.com/<YOUR_TENANT_ID>/adminconsent?client_id=3d61dce1-e589-49f7-bbd6-92512e891896
  3. 03

    Review and accept the permissions

    Open the URL and sign in with an account authorized to grant tenant-wide administrator consent. Review the application name, publisher, and delegated permissions before accepting.

  4. 04

    Verify the enterprise application

    In Enterprise applications, find the application by its client ID. Confirm that administrator consent was granted in the correct tenant.

  5. 05

    Test with an Argos user

    Have a user open Settings → Integrations in Argos and connect Outlook or SharePoint. The user must still sign in and authorize Argos to act on their behalf.

Delegated permissions

The integration uses delegated permissions. Argos acts on behalf of the signed-in user and cannot access content that user cannot access.

IntegrationScopeWhat it allows
Sharedoffline_accessLets Argos refresh access tokens so syncing continues without requiring the user to sign in each time.
SharedUser.ReadReads the signed-in user's basic Microsoft profile.
Sharedopenid, profile, emailAuthenticates the user and returns the identity claims needed to associate the connection with the correct Argos user.
OutlookMail.ReadReads messages and attachments in the signed-in user's mailbox. It does not allow Argos to send, modify, or delete mail.
SharePointFiles.Read.AllReads files the signed-in user can access. It does not allow Argos to create, modify, or delete files.
SharePointSites.Read.AllReads documents and list items in site collections on behalf of the signed-in user.
Review the consent screen

Microsoft can group or repeat permission descriptions across Microsoft Graph and SharePoint resources. If the consent screen shows a permission not listed here, or shows the same permission more than once, send a screenshot to support@joinargos.com before approving it.

Authorization versus syncing

Administrator consent allows users in your tenant to authorize the delegated scopes. It does not cause Argos to ingest every mailbox or SharePoint site in the organization.

  • Outlook: Argos syncs a mailbox only after that user connects Outlook in Argos.
  • SharePoint: The permission authorizes access to files the signed-in user can access. In Argos, the user selects the files or folders to add as matter sources, and Argos syncs those selected sources and their updates.

Troubleshooting

IssueWhat to check
Microsoft shows Need admin approvalConfirm that administrator consent was granted in the same tenant as the user's work account.
The wrong enterprise application was approvedSearch by client ID and confirm it is 3d61dce1-e589-49f7-bbd6-92512e891896. Do not use the client ID from your WorkOS SSO application.
Consent succeeded but the user still cannot connectHave the user restart the connection from Settings → Integrations and sign in with an account from the approved tenant.
The consent screen shows unexpected permissionsDo not approve until Argos confirms the application and requested permissions. Send the consent-screen screenshot to support.

Related guides

Consent review

Unexpected permissions?

Send Argos a sanitized screenshot of the consent screen before approving anything that differs from this guide.

Contact support