Connect SharePoint to Uku
Who can do this
Section titled “Who can do this”- Company Admins and Company Owners with access to Settings & Apps, on the Elite plan.
- Setting up the prerequisites in Microsoft Azure usually requires a Microsoft 365 / Azure AD administrator at your firm. If you do not have access to your company’s Azure portal, ask your IT contact to complete the Azure steps and share the four values with you.
What gets connected
Section titled “What gets connected”Once SharePoint is connected through the Documents app, Uku creates per-client folders inside a main folder you choose on a SharePoint site, and syncs files from tasks, emails, and the Client Portal there. The connection uses the Microsoft Graph API with an Azure AD app registration — Uku authenticates as the registered application using a client secret, not as an individual user.
Prerequisites in Microsoft Azure
Section titled “Prerequisites in Microsoft Azure”You will need four values to complete the connection. Three of them come from registering an application in Azure Active Directory; the fourth is the URL of the SharePoint site you want to use.
1. Register an application in Azure AD
Section titled “1. Register an application in Azure AD”- Sign in to the Microsoft Azure portal with an account that has permission to register apps.
- Open Azure Active Directory (now also called Microsoft Entra ID).
- Go to App registrations and click New registration.
- Give the app a name (for example,
Uku Documents) and complete the registration.
2. Copy the Application (client) ID and the Tenant ID
Section titled “2. Copy the Application (client) ID and the Tenant ID”- Open the registered app’s overview.
- Copy Application (client) ID — this is your Client ID in Uku.
- Copy Directory (tenant) ID — this is your Tenant ID in Uku.
3. Create a Client Secret
Section titled “3. Create a Client Secret”- In the app’s left menu, open Certificates & secrets.
- Click New client secret, give it a description and an expiry.
- Copy the Value of the secret immediately — Azure only shows it once. This is your Client Secret in Uku.
4. Grant API permissions
Section titled “4. Grant API permissions”- In the app’s left menu, open API permissions.
- Add a permission for Microsoft Graph → Application permissions.
- Add at minimum Sites.Read.All for read-only access. To allow Uku to upload files, create folders, and download files (which is what the Documents app actually does), grant Sites.ReadWrite.All instead.
- Click Grant admin consent for your tenant.
5. Find the Site URL
Section titled “5. Find the Site URL”Open the SharePoint site you want Uku to use and copy the URL from the address bar. It looks like https://yourcompany.sharepoint.com/sites/yoursite.
Connect SharePoint in Uku
Section titled “Connect SharePoint in Uku”Path: Settings & Apps → Documents → Settings tab
- Open the Documents app and switch to the Settings tab. If the Documents app is not active yet, activate it from the Overview tab first.
- In the list of supported services, find SharePoint and click Connect.
- Paste the four values into the connection dialog:
- Site URL — the SharePoint site URL from step 5.
- Client ID — the Application (client) ID.
- Tenant ID — the Directory (tenant) ID.
- Client Secret — the secret value you copied in Azure.
- Click Connect. Uku tests the connection by listing the site’s drive — if anything is wrong, you will see an error in the dialog and nothing is saved.
After a successful test you are returned to the Settings tab with SharePoint marked as connected. Pick the Main folder under which Uku should create per-client folders, then configure the rest of the Documents app the same way as for Google Drive or Dropbox. See Documents app — Google Drive and Dropbox integration for the full Settings tab reference (folder structure, public/private, year/month, backup options).
How documents flow once connected
Section titled “How documents flow once connected”Files uploaded to tasks, sent into the Mailbox, or attached through the Client Portal are saved into the SharePoint folder structure Uku creates under your chosen Main folder. Opening a file from a client view in Uku takes you straight into SharePoint — there is no Uku-side download step.
Switching providers or disconnecting
Section titled “Switching providers or disconnecting”You can only have one cloud storage provider connected at a time. To switch from SharePoint to another provider (or vice versa), open the Documents app Settings tab and click Disconnect on the active service first, then connect the new one. Disconnecting does not delete files already synced to SharePoint — it only stops new uploads from flowing.
Troubleshooting
Section titled “Troubleshooting”The connection test fails immediately
Section titled “The connection test fails immediately”Check each of the four values:
- Site URL must be a full
https://...sharepoint.com/sites/<name>URL, not just the hostname. - Tenant ID is the Directory (tenant) ID from the Azure AD overview, not the friendly tenant name.
- Client Secret is the Value of the secret, not the Secret ID. If you forgot to copy it when it was created, generate a new one in Azure — the value is shown only once.
If all four look correct, verify in Azure that the app registration has Microsoft Graph → Sites.Read.All (or Sites.ReadWrite.All) under Application permissions and that admin consent has been granted for your tenant.
File uploads from tasks or the Client Portal fail
Section titled “File uploads from tasks or the Client Portal fail”Uploads need write access. If you only granted Sites.Read.All, Uku can list folders and confirm the connection but cannot upload. Add Sites.ReadWrite.All in Azure under API permissions, click Grant admin consent, and try again.
The connection worked yesterday and now fails
Section titled “The connection worked yesterday and now fails”Most often the Azure client secret has expired. Open the Azure app registration, go to Certificates & secrets, create a New client secret, and re-save the connection in Uku with the new value. Plan the next rotation before that expiry date.
I cannot find App registrations or grant admin consent
Section titled “I cannot find App registrations or grant admin consent”These actions require Azure AD administrator privileges in your tenant. Most users at a company do not have this by default. Ask your IT or Microsoft 365 administrator to register the app and grant consent, then share the four values with you for the Uku side.
The list of folders inside SharePoint is empty in Uku
Section titled “The list of folders inside SharePoint is empty in Uku”Uku reads the default document library (drive) of the SharePoint site you point at. If the site has multiple document libraries and you want a non-default one, contact Uku support — selecting a specific drive is not exposed in the connection dialog.