Skip to content
background-image background-image

Microsoft Sharepoint O365 File Writer Connector

[ | version 3.5]


The connector is permitted for use of the platform background agent.

Connector processing type: Row by row!

This connector allows to upload files to Microsoft Sharepoint O365 through Graph API. More information in documentation.

Required Microsoft Graph API Application permissions

  • Files.ReadWrite.All
  • Sites.Read.All

Site and Drive

One of configuration options are Site and Drive.

Site can be just company sharepoint but it can also contain sub sites. In web URL it can be behind sites path e.g. which shows sub site name DEV. In this case Site configuration attribute will be specified as of DEV if DEV sub site is needed.

Site have data unit/s named drive which is another part of URL behind site or sub site. Typical example is Documents but is a little tricky because in URL it is displayed as Shared%20Documents, e.g. Other drives have usually same name as in URL.

But when site or drive is specified incorrectly connector will print available names to error message which can help to configure it.


Just for example how you can make input for this connector by JS Mapper connector as step before.

        "Directory": "/drive/root:/testFolder", 
        "Name": "file.txt",
        "Data": "VGVzdGluZyBmaWxlIGNvbnRlbnQ="


Azure Auhtentication configuration


To successfully use this configuration, you must have defined Application registration on your Tenant ID Instance on

  1. Open Microsoft Azure portal.
  2. Go to Manage Azure Active Directory for your Tenant ID.
  3. Click on App registrations on the left side menu.
  4. Click on New registration:
    1. Fill Name
    2. Set Supported account types to Accounts in this organizational directory only (Single tenant)
    3. Click on Register button
  5. When App registration already exists click on existing app registration in list
  6. Click on Authentication on the left side menu:
    1. Check ID tokens (used for implicit and hybrid flows) property.
  7. Click on API permissions on the left side menu:
    1. Click on Add a permission
    2. Select Microsoft Graph tile from Microsoft APIs on the right side menu:
      1. Select Application permissions.
      2. Check corresponding API permissions.
      3. Click on Add permissions button.
    3. When its needed click on Grant admin consent button over assigned permissions list.
  8. Use filled properties from App registration application into configuration:
    1. Click on Certificates & secrets on the left side menu:
      1. Add new client secret value.
      2. Take this new created Value and insert it into Client Secret configuration property.
    2. From the Overview left side menu:
      1. Take Application (client) ID and insert value into Azure Client Application ID configuration property.
      2. Take Directory (tenant) ID and insert value into Tenant ID configuration property.

Azure Active Directory Instance

URL of AAD Instance that the authentication is provided.

Tenant ID

Tenant identifier that the data should be returned for. Is visible on azure portal in application Overview in App registrations.


Azure Client Application ID

The unique identifier for Azure Client Application. Is visible on azure portal in application Overview in App registrations. The application must have defined API permissions for specific operations.


Resource ID

ID of the resource to get the data.

Api Version

API Version.

Default: v1.0

Authentication Mode

Supported authentication modes

  • Username and password
  • Client secret


Client user name


Client password


Define Subscription Bind Mailbox which is used for emails processing.

Client Secret

Client secret

Sharepoint File Write configuration

Working Mode

  • Fail when file exists - failed when file already exists
  • Replace existing file - when file already exists its content is replaced by new content
  • Create new file with number increment name - file is uploaded with new created name with some increment post-name

Delete temporary file when error occured

If set to true, temporary file will be deleted after session expires.

Sharepoint Site configuration


Name of site or sub site.




Name of custom drive, empty will use root drive. Typical can be Documents. To find your specific DriveId use Microsoft Graph explorer


  • b!dbzcQi3Vp0ap4vuJ7Pxo0U2JU6-0n2RBvWyDxr9XDLo8O0zSh0XESLUh8xzuXIcw
  • b!dbzcQi3Vp0ap4vuJ7Pxo0U2JU6-0n2RBvWyDxr9XDLqjKHPd7fh4S5eC-x9wESjl

Input & Output Schema


Sharepoint O365 file writer input (ver. 1.0.0)

Column Data type Allow null Description
Directory string No Path to file
Name string No Name of file
Data Base64 No File content

Example input data

Directory: string Name: string Data: Base64
/drive/root:/testFolder file.txt VGVzdGluZyBmaWxlIGNvbnRlbnQ=


This connector has no output schema.

Release notes


  • Added new description and icon.


  • Fixed shared nuget package versions.


  • Fixed right processing of nullable properties.