Overview
The SharePoint integration is a read-only connection that lets Axiamatic read files and sites from your Microsoft 365 tenant. What Axiamatic can see depends on the access method you choose and the permissions your Microsoft 365 administrator grants. Most methods need your administrator at some point, so check who that is before you start.
Choose an access method
Axiamatic offers four ways to connect to SharePoint. They differ in who grants access and how many sites Axiamatic can reach, so pick one before you open Settings.
Default Authentication (recommended) gives Axiamatic access to every site the connecting user can open. Your Microsoft 365 admin approves Axiamatic once.
Selected Sites Access (User Delegated) limits Axiamatic to the sites your admin grants one by one. The connecting user must be a member of those sites.
Selected Sites, Folders & Files Access (Application) lets an admin or site owner grant specific sites, folders and files at the application level. The connecting user does not need to be a site member.
Third-party Client App (Client Credential) connects through an Entra ID app registration instead of a person. Your admin sets its permissions and no one signs in.
Axiamatic recommends Default Authentication for most teams because it needs one admin approval and covers the sites you already work in.
Choose Selected Sites Access (User Delegated) or Selected Sites, Folders & Files Access (Application) when your security policy limits Axiamatic to specific sites.
Choose Client Credential for server-to-server access that does not depend on any one person's account.
Connect with your Microsoft account
Default Authentication and Selected Sites Access (User Delegated) Methods
Both methods use your Microsoft sign-in. The first connection in your organization needs admin approval, so you connect once to request approval and again after your admin approves.
Stage 1: Request access
Click your profile icon and select Settings, then open Integrations.
In the File Sync section, click Connect on the SharePoint card.
Choose Shared Connection or Private Connection.
Select Default Authentication or Selected Sites Access (User Delegated).
Enter your Azure Tenant ID when prompted. See how to get Azure Tenant ID
In the Microsoft sign-in window, choose the account whose SharePoint you want to connect. If you are not signed in, enter your Microsoft email and password and click Sign in.
Review the permissions Axiamatic requests.
If Microsoft asks for a reason, enter a short one such as
project analyticsso your admin knows why you need access.Click Request approval. Microsoft sends the request to your admin.
Note: Microsoft handles the sign-in and Axiamatic does not store your credentials.
Finish connecting after approval
Wait for the email from Microsoft that says your admin approved Axiamatic.
Go back to Settings > Integrations and click Connect on the SharePoint card.
Choose the same connection type and access method as before.
Select the same Microsoft account. Microsoft usually skips the permissions screen this time.
Check that the SharePoint card shows Connected.
Important: If you chose Selected Sites Access (User Delegated), Axiamatic reads nothing until your admin grants each site.
The next two sections are for your admin.
Stage 2: Approve the Axiamatic app
This task is for Azure administrators. When someone requests access, the request waits in Microsoft Entra ID until an admin approves it.
Sign in to the Azure portal with admin credentials.
Go to Microsoft Entra ID.
Click Enterprise applications.
In the left navigation, click Admin consent requests under Activity.
Find Axiamatic under the My pending or All tab.
Click Axiamatic to open the review panel on the right.
Click Review permissions and consent and accept the permissions.
Microsoft emails the person who requested access so they can finish connecting. For more on this process, see Microsoft's guide to reviewing admin consent requests.
Stage 3: Grant access to selected sites
This task is for Microsoft 365 administrators and applies only to Selected Sites Access (User Delegated). Axiamatic can read a site only after you grant the Axiamatic app permission to it through the Microsoft Graph API.
Get the site ID of the SharePoint site you want to grant.
Send the request below to the Microsoft Graph API. Set
{site-id}to the site ID,<customer-admin-token>to your admin bearer token and<AXM_APP_ID>to the Axiamatic application ID you received.Repeat the request for each site you approve.
POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions
Content-Type: application/json
Authorization: Bearer <customer-admin-token>
{
"roles": ["read"],
"grantedToIdentities": [
{
"application": {
"id": "<AXM_APP_ID>",
"displayName": "Axiamatic Sharepoint App"
}
}
]
}
Connect with application permissions
The Selected Sites, Folders & Files Access (Application) method lets an admin grant Axiamatic specific sites, folders or files. The connecting user does not need to be a member of those sites. Setup has three stages, and Axiamatic reads nothing until the second stage is done.
Important: Stage 1 alone gives Axiamatic no access to SharePoint content. Access starts only after you complete Stage 2 for each site, folder or file.
Stage 1: Authorize the app
A Microsoft 365 or Office 365 administrator completes this stage.
Click your profile icon and select Settings, then open Integrations.
In the File Sync section, click Connect on the SharePoint card.
Choose Shared Connection or Private Connection and click Proceed.
Select Selected Sites, Folders & Files Access (Application).
Enter your Azure Tenant ID and click Connect. See how to get Azure Tenant ID
In the Microsoft permissions window, click Accept.
Check that the SharePoint card shows Connected.
Stage 2: Grant access to sites, folders, or files
A SharePoint site owner, SharePoint administrator or Microsoft 365 administrator completes this stage through the Microsoft Graph API. Axiamatic recommends the read role because it keeps access as narrow as possible.
To grant a whole site:
Get the site ID of the SharePoint site.
Send the request below. Set
{site-id}to the site ID,<app-id>to the Axiamatic SharePoint RSC application ID and<admin-access-token>to a valid Microsoft Graph access token.Repeat the request for each site you approve.
POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissions
Authorization: Bearer <admin-access-token>
Content-Type: application/json
{
"roles": ["read"], "grantedToIdentities": [
{
"application": {
"id": "<app-id>",
"displayName": "Axiamatic for SharePoint-RSC"
}
}
]
}To grant a single folder or file:
Get the site ID and the item ID of the folder or file.
Send the request below. Set
{site-id}to the site ID,{folder-item-id}to the item ID,<app-id>to the Axiamatic SharePoint RSC application ID and<admin-access-token>to a valid Microsoft Graph access token.Repeat the request for each folder or file you approve.
POST https://graph.microsoft.com/v1.0/sites/{site-id}/drive/items/{folder-item-id}/permissions
Authorization: Bearer <admin-access-token>
Content-Type: application/json
{
"roles": ["read"],
"grantedTo": {
"application": {
"id": "<app-id>"
}
}
}Note: Replace <customer-admin-token> with your admin's bearer token, and <AXM_APP_ID> with the Axiamatic application ID provided to you.
Stage 3: Add the locations in Axiamatic
Open Settings > Integrations.
Click Configure on the SharePoint card.
In the pop-up, enter the URLs of the sites, folders and files you granted in Stage 2.
Click Save. Axiamatic now reads only those locations.
Note: To revoke access, remove the Axiamatic permission from the site, folder or file in SharePoint.
Connect with a client app
The Third-party Client App (Client Credential) method connects Axiamatic through an Azure AD or Entra ID app registration instead of a signed-in user. It uses OAuth 2.0 client credentials, so no one needs to sign in or request approval from Axiamatic.
Important: Your administrator must give the app registration the right application permissions and grant admin consent before you connect. The connection fails without this step.
Before you start, collect four values: your Azure Tenant ID, the app's Client ID and Client Secret and the URL of the SharePoint site to connect.
Click your profile icon and select Settings, then open Integrations.
In the File Sync section, click Connect on the SharePoint card.
Choose Shared Connection or Private Connection.
Select Third-party Client App (Client Credential).
Enter your Azure Tenant ID, Client ID, Client Secret and SharePoint site URL. See how to get Azure Tenant ID
Click Save. The connection is ready as soon as you save.
Add SharePoint sites and lists
After the card shows Connected, tell Axiamatic which SharePoint locations to pull data from. You can add a whole site or a single list.
Open the site or list in your browser and copy its URL. A site URL looks like
https://<domain name>.sharepoint.com/sites/<site name>. A task list URL looks likehttps://<domain name>.sharepoint.com/sites/<site name>/Lists/Tasks.Paste the URL into the pop-up in Axiamatic.
Click Save. Axiamatic starts pulling data from that location right away.
Repeat these steps for each site or list you want to add.
How-to video
Important: Your customer administrator must configure the required permissions and grant admin consent before the application can access any SharePoint resources. Without this, the connection will fail.
How to get Azure Tenant ID?
How to get Azure Tenant ID?
Follow these steps to retrieve the ID for a Microsoft Entra tenant in the Azure portal.
Sign in to the Azure portal.
Confirm you are signed in to the tenant for which you want to retrieve the ID. If not, switch directories to the correct tenant.
Under the Azure services heading, select Microsoft Entra ID. If you don't see Microsoft Entra ID here, use the search box to find it.
Find the Tenant ID in the Basic information section of the Overview screen.
Copy the Tenant ID by selecting the Copy to clipboard icon shown next to it. You can paste this value into a text document or other location.
Finding your SharePoint URL
Go to your SharePoint and copy the URL for the location you want to add. Replace <domainname> and <sitename> with the actual values for your organization. These will be unique to your SharePoint setup.
To link a SharePoint site: Navigate to the site in your browser and copy the URL. It will look like:
https://<domain name>.sharepoint.com/sites/<site name>
To link a specific Task list: Open the list in your browser and copy the URL from the address bar. It will look like:
https://<domain name>.sharepoint.com/sites/<site name>/Lists/Tasks
Paste the copied URL into the pop-up and click Save. Axiamatic will begin pulling data from that location immediately.
Repeat this for each site or list you want to connect.
Troubleshooting
If admins are not receiving access requests or team members cannot submit requests, these Azure settings may need to be configured by your IT administrator.
Issue: Admin Not Receiving Requests
Admin Solution: Enable Admin Consent Requests
Access Azure Portal:
Sign in to the Azure Portal (
portal.azure.com) with admin credentials
Configure Admin Consent Settings:
Issue: Team Members Cannot Submit Consent Requests
Admin Solution: Configure User Consent Settings
Access User Consent Settings:
From the same Consent and permissions section, click User consent settings
This option appears directly above Admin consent settings
Select Appropriate Permission Level:
Choose one of the more permissive options at the bottom of the page
This allows people to either consent directly or submit requests for admin review
Admin Approval Process
While team members wait for approval, Azure administrators need to review and approve the access request through the Azure Portal.
For Azure Administrators:
Step 1: Access Azure Portal
Sign in to https://portal.azure.com/ with your admin credentials
Step 2: Navigate to Admin Consent Requests
Go to Microsoft Entra ID
Click Enterprise applications
In the left navigation, click Admin consent requests (under Activity)
Step 3: Review and Approve Request
Locate the Axiamatic application under My pending or All tabs
Click on the application to open the review panel on the right
Click Review permissions and consent
Approval complete! The requesting team member will receive an email notification and can go ahead with the integration.
Need additional guidance? For detailed information on the admin consent process, refer to Microsoft's comprehensive documentation: Review admin consent requests
How Axiamatic Uses Your SharePoint Data
Read-only access only - Axiamatic cannot modify, delete, or create any data in your SharePoint account.
What Axiamatic accesses:
File Access (Critical)
Permission:
files.read.allWhat it does: Reads all files that you can access in SharePoint
Used for: Downloading SharePoint files and folders for analysis
Site Information (Critical)
Permission:
sites.read.allWhat it does: Reads items across all sites you can access in SharePoint
Used for: Resolving SharePoint links and fetching drive and folder IDs
User Information (Enhanced Features)
Permission:
user.readbasic.allWhat it does: Reads user profile information
Used for: Attributing files and managing ownership assignments to users
Your data security: All permissions are delegated, meaning Axiamatic only accesses information you already have permission to view in SharePoint and never makes changes to your account.
For pricing information, demo requests, or assistance, contact us at [email protected]

















