SharePoint Step

The SharePoint step uploads files to a SharePoint document library using a named connection. Use it to deliver workflow outputs to the document libraries and sites your organization relies on for internal collaboration and compliance.

Configuration

name	type	required	description
`connection`	string	yes	The name of the SharePoint connection to use, as configured in Integrations.
`action`	string	yes	The operation to perform. Must be `UPLOAD_FILE`.
`drive`	string	yes	The target SharePoint drive or site identifier.
`folder`	string	no	An optional folder path within the drive.
`files`	array	yes	One or more files to upload. At least one file is required. See Files below.

Files

Each entry in the files array defines a file to upload and where it comes from.

name	type	required	description
`source`	string or object	yes	The file to upload. See File sources below.
`name`	string	yes	The file name to use in SharePoint.

File sources

The source field accepts several formats depending on where the file comes from:

Object reference with ID: { "id": "string", "downloadUrl": "string" } — references a file by its ID. Both id and downloadUrl are required.
Object reference with URL only: { "downloadUrl": "string" } — references a file by download URL, without an ID.
Generated file descriptor: { "name": "string", "metadata": { "contentType": "string", "size": number, "createdAt": "string", "updatedAt": "string" } } — describes a workflow-generated file. Only name is required; all metadata fields are optional.
String URL or handle: A plain string used as a direct file reference.

Example

The example below uploads two files to a SharePoint document library: one referenced by ID and one workflow-generated image.

{
  "connection": "sharepoint-prod",
  "action": "UPLOAD_FILE",
  "drive": "Marketing",
  "folder": "Documents/Assets",
  "files": [
    {
      "source": {
        "id": "file-654",
        "downloadUrl": "https://files.example.com/download/file-654"
      },
      "name": "brand-guide.pdf"
    },
    {
      "source": {
        "name": "logo.png",
        "metadata": { "contentType": "image/png", "size": 4096 }
      },
      "name": "logo.png"
    }
  ]
}