---
updatedAt: 2026-02-26T15:12:30.000Z
agentTools:
  projectIndex: https://developer.intellistack.com/llms.txt
---

# SharePoint Step

Upload files to SharePoint as part of your workflow. Use this step to save user-uploaded files and workflow-generated documents to organizational sites and document libraries.

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](#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](#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.

```json Upload files to SharePoint
{
  "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"
    }
  ]
}
```