Xakia Help Center

SharePoint Online - Error Reference Guide

Updated today

This article provides a structured reference for common errors encountered within the Xakia–SharePoint Online integration. Each entry sets out the error as it appears, the likely cause, and the recommended steps to resolve it.

Invalid Data - Read only Field

Cause	Resolution
Xakia exports metadata as Single Line of Text. If the target SharePoint column is configured with a different data type (e.g. Choice, Number, or Date), the write operation will fail. The error message displayed is: "Invalid data has been used to update the list item. The field you are trying to update may be read only."	In SharePoint, navigate to the relevant column and select Column Settings > Edit. Confirm the Type is set to Single line of text. If the type is incorrect, remove the column and recreate it with the correct data type, then re-map it in Xakia.

Unauthorized Operations

Cause	Resolution
The site collection authentication step has not been completed. Each site collection must be individually authenticated with Xakia before document management can function. The error message displayed is: "Attempted to perform an unauthorized operation."	Refer to the Authentication section of the following Xakia Knowledge Base article: Set up the SharePoint Online Integration

File not Found

Cause	Resolution
The Root Site Collection URL entered in Admin > Integrations > Document Management is incorrect. This typically occurs when a subsite URL has been entered in place of the root site URL.	Navigate to Admin > Integrations > Document Management. Update the Root Site Collection URL to the root of your SharePoint tenant, e.g. `https://<example>.sharepoint.com/` Ensure there are no trailing characters, path segments, or subsite references after the base URL.
The site or subsite URL entered in the Folder Placement field is incorrect. This occurs when the URL references a document library directly, rather than the site or subsite that contains it.	Ensure the URL entered in the Folder Placement field links to the Site or Subsite — not the document library itself. The document library should be specified separately in the Document Library field.

404 Not Found

Cause	Resolution
This error can occur when a Field Mapping references a protected or reserved SharePoint column name such as "Name" or "Title". SharePoint does not permit writes to these fields via the standard API.	Review the Field Mappings in Xakia and identify any mappings that use reserved SharePoint column names. Rename the affected mappings to non-reserved column names, e.g. "Matter Name" instead of "Name".

Error Code AADSTS500011

Cause	Resolution
The Root Site Collection URL is referencing a SharePoint subsite rather than the root tenant site. Azure Active Directory cannot locate the resource principal at the specified path.	Navigate to Admin > Integrations > Document Management. Update the Root Site Collection URL to the root of your SharePoint tenant, e.g. `https://<example>.sharepoint.com/` Remove any path segments that reference subsites or document libraries.

Error Code ADDSTS50158 - MFA Session Expired

Cause	Resolution
The global administrator's multi-factor authentication (MFA) session has expired. When the MFA session lapses, Azure Active Directory cannot complete the authentication handshake required by the integration.	Ask the global administrator to open a new private or incognito browser window. Navigate to the Xakia authentication URL. Sign in and complete the MFA prompt when it appears to re-establish a valid session.

Column Does Not Exist

Cause	Resolution
A column referenced in Xakia's Field Mappings has been deleted from SharePoint. The mapping continues to reference a column that no longer exists in the target site.	Remove the affected field mapping in Xakia, or Remap it to an existing column in SharePoint, or Recreate the deleted column in SharePoint and re-link the field mapping.