View as Markdown
Smartsheet icon

Smartsheet ACTION

Import Sheet

Import a CSV or XLSX file as a brand new Smartsheet sheet inside a workspace or a folder. Returns the new sheet under result, including its ID and permalink. To create a sheet by defining columns yourself instead, use Create Sheet. See the documentation
  • Action
  • Writes data
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Smartsheet account once, then configure and run Import Sheet from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "smartsheet-import-sheet",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    smartsheet: { authProvisionId: "apn_xxxxxxx" },
    filePath: "File Path or URL",
    syncDir: "SyncDir",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Import Sheet inputs
Property Type Description
filePath File Path or URL string
A file URL, or a path to a file in the /tmp directory (e.g. /tmp/data.csv). Supported formats: CSV (.csv) and Excel (.xlsx); a URL with no extension is treated as CSV.
Required
syncDir SyncDir dir
Optional
sheetName Sheet Name string
Name for the imported sheet. Must use ASCII characters.
Required
headerRowIndex Header Row Index integer
Zero-based index of the row to use as column headers. Defaults to 0, the first row.
Optional
workspaceId Workspace ID string
Import into this workspace (e.g. 1234567890123456). Provide either Workspace ID or Folder ID (at least one is required). Use List Workspace Options to find workspace IDs.
Optional
folderId Folder ID string
Import into this folder (e.g. 9876543210987654). Provide either Workspace ID or Folder ID (at least one is required). Use List Folder Options with a workspace ID to find folder IDs.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
smartsheet-import-sheet
Version
0.0.4
App
Smartsheet
Authentication
OAuth
Read-only
No
Destructive
No
Open world
Yes