> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SharePoint

> SharePoint is a content and collaboration app for managing sites, files, lists, and pages via your connected account.

Use this app when your workflow needs SharePoint content, files, lists, or site pages. Choose read actions to look up sites, drives, lists, and items, and write actions to create or update records and files.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Label for the step in the workflow canvas. |
| Authentication | Yes | The connected SharePoint account to use for this step. |
| Action | Yes | The SharePoint action to perform (for example Get current user, List sites, Get site, Get site by hostname). |
| Arguments | Yes | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails. |

Before you configure this step, connect SharePoint in **Integrations** for your workspace using the sign-in flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section renders a form driven by the action's input schema. Fields that refer to existing records include dropdown pickers.

Switch to the **Raw JSON** tab when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

## Common actions

| Action | Description |
| - | - |
| **Get current user** | Retrieve the connected SharePoint user profile. |
| **List sites** | List the SharePoint sites the connected account can access. |
| **Get site** | Retrieve details for a SharePoint site by ID. |
| **Get site by hostname** | Retrieve a SharePoint site by hostname or URL. |
| **List site drives** | List the document libraries for a SharePoint site. |
| **Get drive** | Retrieve metadata for a SharePoint drive by ID. |
| **List drive children** | List files and folders in a SharePoint drive. |
| **Get drive item** | Retrieve a file or folder in a drive by item ID. |
| **Upload file** | Upload a file to a SharePoint folder. |
| **Update drive item** | Update properties of a SharePoint file or folder. |
| **List lists** | List all SharePoint lists in the current site. |
| **Get list** | Retrieve a SharePoint list by its title. |
| **Get list items** | Retrieve items from a SharePoint list by title. |
| **Get list item** | Retrieve one SharePoint list item by ID. |
| **Create list item** | Create a new item in a SharePoint list by GUID. |

Destructive actions, such as deleting records, are not available in the workflow action picker.

## Output

This step stores the SharePoint response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Open **Integrations** and connect SharePoint if you have not already done that.
2. Add a **SharePoint** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Get current user** in **Action**.
5. Fill in the required fields. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Use cases

### Create a list item from a form

1. Get list
2. Create list item
3. Get list item

### Upload and tag a file

1. List site drives
2. Upload file
3. Update drive item

### Review a site page

1. List site pages
2. Get page content
3. Get site

## Notes

* This step depends on a connected SharePoint integration in your workspace.
* The workflow action picker shows a curated set of actions. Agents with the SharePoint tool can use more of them.
* The sign-in screen may show third-party authorization branding.

## Using SharePoint as an Agent Tool

You can also add SharePoint as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **SharePoint**. In the tool settings panel, choose the connected account the agent should use. The agent calls SharePoint actions when they are relevant to the conversation.

See also: [Integrations](https://docs.fetchhive.com/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.