> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartsheet Connector

## Intro

Smartsheet is an online project management, productivity and team collaboration SaaS application. Domo's Smartsheet connector allows you to retrieve data about folders, sheets, workspaces, users, and so on. To learn more about the Smartsheet API, visit their website ([https://smartsheet-platform.github.io/api-docs/](https://smartsheet-platform.github.io/api-docs/ "https://smartsheet-platform.github.io/api-docs/") ).

The Smartsheet connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to the Smartsheet in the Data Center. This topic discusses the fields and menus that are specific to the Smartsheet connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> This connector is typically used to pull spreadsheet data into Domo. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> N/A </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Product/project managers </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> Depends on the amount of data and the scope of the system. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> 4 </p></td></tr></tbody></table>

## Best Practices

* As this connector does not support relative dates, "Replace" is the best choice for scheduling.
* API calls are limited to 300 calls per minute. However, most reports do not result in a lot of calls (aside from the "Users

- All Sheets" report).

## Prerequisites

To connect to the Smartsheet API and create a DataSet, you must have the following:

* The email address you entered when you signed up for a Smartsheet account
* Your Smartsheet password

## Connecting to Smartsheet

This section enumerates the options in the **Credentials** and **Details** panes in the Smartsheet connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Data Connector](/s/article/360042926274 "Adding a DataSet Using a Data Connector").

### Credentials Pane

The Domo Smartsheet connector uses OAuth to connect, so there is no need to enter credentials within Domo. Click **Connect** (or select **Add Account** if you have existing Smartsheet accounts in Domo)

to open the Smartsheet OAuth screen where you can enter your Smartsheet email address and password. Once you have entered valid credentials, you can use the same account any time you go to create a new Smartsheet DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Managing User Accounts for Connectors](/s/article/360042926054 "Managing User Accounts for Connectors").

<Note>
  **Note:** The SmartSheet connector requires that you reauthenticate your account throughout the life of the connection. For information about reauthenticating an account, see [Reconnecting Connectors for Accounts](/s/article/360042926054 "Managing User Accounts for Connectors").
</Note>

### Details Pane

This pane contains a primary menu in which you select a report, along with two fields in which you can specify information to retrieve.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select a Smartsheet report. The following reports are available: </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"><p> Columns - Columns in Sheet </p></td><td colspan="1" rowspan="1"><p> Returns data about columns within a specified sheet. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Folders - All Folders </p></td><td colspan="1" rowspan="1"><p> Returns a list of all folders in your account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Folders - Single Folder </p></td><td colspan="1" rowspan="1"><p> Returns data about a specified folder. You must enter a folder name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Folders - All Folders Inside a Folder </p></td><td colspan="1" rowspan="1"><p> Returns a list of subfolders within a specified folder. You must enter a folder name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Reports - Single Report </p></td><td colspan="1" rowspan="1"><p> Returns data from a specified report. You must select a report name in <b> Report Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Reports - All Reports </p></td><td colspan="1" rowspan="1"><p> Returns a list of all reports used by the account users. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search - All </p></td><td colspan="1" rowspan="1"><p> Searches for a specified search term within your entire account and returns results with that search term. You must enter a search term in <b> Search </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search - In Sheet </p></td><td colspan="1" rowspan="1"><p> Searches for a specified search term within a specified sheet and returns results with that search term. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> and a search term in <b> Search </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Shares for Workspace </p></td><td colspan="1" rowspan="1"><p> Returns a list of users who have access to a specified workspace. You must enter a workspace name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Shares for Sheet </p></td><td colspan="1" rowspan="1"><p> Returns a list of users who have access to a specified sheet. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheets </p></td><td colspan="1" rowspan="1"><p> Returns a list of all sheets in your account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheets - Single Sheet </p></td><td colspan="1" rowspan="1"><p> Returns data a specified sheet. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheets - Sheet Version </p></td><td colspan="1" rowspan="1"><p> Returns the version number for a specified sheet. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Sheets - Publish Status </p></td><td colspan="1" rowspan="1"><p> Returns publish status information for a specified sheet. You must enter a sheet name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Templates </p></td><td colspan="1" rowspan="1"><p> Returns a list of all templates in your account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Users - All Users </p></td><td colspan="1" rowspan="1"><p> Returns data about all users of the account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Users - Current User </p></td><td colspan="1" rowspan="1"><p> Returns data about the authenticated user. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Users - All Sheets </p></td><td colspan="1" rowspan="1"><p> Returns a list of all sheets used by account users. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Workspaces - All Workspaces </p></td><td colspan="1" rowspan="1"><p> Returns a list of all workspaces in your account. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Workspaces - Single Workspace </p></td><td colspan="1" rowspan="1"><p> Returns data about a specified workspace. You must enter a workspace name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Workspaces - All Folders in a Workspace </p></td><td colspan="1" rowspan="1"><p> Returns a list of folders within a specified workspace. You must enter a workspace name in <b> Workspace/Folder/Sheet Name </b> for this report to run. </p></td></tr></tbody></table><p /></td></tr><tr><td colspan="1" rowspan="1"><p> Workspace/Folder/Sheet Name </p></td><td colspan="1" rowspan="1"><p> Enter the name of the workspace, folder, or sheet you want to retrieve information for. Many reports do not work unless a name is specified. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Search </p></td><td colspan="1" rowspan="1"><p> Enter the search term you want to retrieve data for. Some reports do not work unless a search term is specified. </p></td></tr></tbody></table>

### FAQ

<AccordionGroup>
  <Accordion title="What version of the Smartsheet API does this connector use?">
    This connector uses version 2.0 of the Smartsheet API ([https://api.smartsheet.com/2.0](https://api.smartsheet.com/2.0).)
  </Accordion>

  <Accordion title="Which endpoint(s) does each report call in this connector?">
    <table data-aura-rendered-by="33:195;a"><tbody><tr><th colspan="1" rowspan="1" width=""> Report Name </th><th colspan="1" rowspan="1" width=""> Endpoint URL </th></tr><tr><td colspan="1" rowspan="1"> Columns - Columns in Sheet </td><td colspan="1" rowspan="1"> /sheets/{sheetId}/columns </td></tr><tr><td colspan="1" rowspan="1"> Folders - All Folders </td><td colspan="1" rowspan="1"> /home/folders </td></tr><tr><td colspan="1" rowspan="1"> Folders - Single Folder </td><td colspan="1" rowspan="1"> /folders/{folderId} </td></tr><tr><td colspan="1" rowspan="1"> Folders - All Folders Inside a Folder </td><td colspan="1" rowspan="1"> /folders/{folderId}/folders </td></tr><tr><td colspan="1" rowspan="1"> Reports - Single Report </td><td colspan="1" rowspan="1"> /reports/{reportId} </td></tr><tr><td colspan="1" rowspan="1"> Reports - All Reports </td><td colspan="1" rowspan="1"> /reports/ </td></tr><tr><td colspan="1" rowspan="1"> Search - All </td><td colspan="1" rowspan="1"> /search </td></tr><tr><td colspan="1" rowspan="1"> Search - In Sheet </td><td colspan="1" rowspan="1"> /search/sheets/{sheetId} </td></tr><tr><td colspan="1" rowspan="1"> Shares for Workspace </td><td colspan="1" rowspan="1"> /workspaces/{workspaceId}/shares/ </td></tr><tr><td colspan="1" rowspan="1"> Shares for Sheet </td><td colspan="1" rowspan="1"> /sheets/{sheetId}/shares/ </td></tr><tr><td colspan="1" rowspan="1"> Sheets </td><td colspan="1" rowspan="1"> /sheets </td></tr><tr><td colspan="1" rowspan="1"> Sheets - Single Sheet </td><td colspan="1" rowspan="1"> /sheets/{sheetId} </td></tr><tr><td colspan="1" rowspan="1"> Sheets - Sheet Version </td><td colspan="1" rowspan="1"> /sheets/{sheetId}/version </td></tr><tr><td colspan="1" rowspan="1"> Sheets - Publish Status </td><td colspan="1" rowspan="1"> /sheets/{sheetId}/publish </td></tr><tr><td colspan="1" rowspan="1"> Templates </td><td colspan="1" rowspan="1"> /templates </td></tr><tr><td colspan="1" rowspan="1"> Users - All Users </td><td colspan="1" rowspan="1"> /users </td></tr><tr><td colspan="1" rowspan="1"> Users - Current User </td><td colspan="1" rowspan="1"> /users/me </td></tr><tr><td colspan="1" rowspan="1"> Users - All Sheets </td><td colspan="1" rowspan="1"> /users/sheets </td></tr><tr><td colspan="1" rowspan="1"> Workspaces - All Workspaces </td><td colspan="1" rowspan="1"> /workspaces </td></tr><tr><td colspan="1" rowspan="1"> Workspaces - Single Workspace </td><td colspan="1" rowspan="1"> /workspaces/{workspaceId} </td></tr><tr><td colspan="1" rowspan="1"> Workspaces - All Folders in a Workspace </td><td colspan="1" rowspan="1"> /workspaces/{workspaceId}/folders/ </td></tr></tbody></table>
  </Accordion>

  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need the email address or user ID and password associated with your Smartsheet account.
  </Accordion>

  <Accordion title="How do I know my Smartsheet account credentials are secure?">
    The login process uses the OAuth process, so your credentials are never seen or stored by Domo. This keeps your login secure. You can revoke Domo's access to your account at any time.
  </Accordion>

  <Accordion title="Do I need a certain kind of account with the data service to set up the connector?">
    Any Smartsheet account can be used to set up the connector.
  </Accordion>

  <Accordion title="How frequently should I update the connector?">
    There is no limitation in scheduling the connector. However, running many datasets frequently can cause API rate limit errors. Update the data only as often as needed and reduce the duplicate or unwanted datasets to avoid rate limit errors.
  </Accordion>

  <Accordion title="Can this connector pull custom fields?">
    The connector can pull your Smartsheet spreadsheets as they exist in Smartsheet. Ensure that the spreadsheets are formatted using the best practices for normalized data.
  </Accordion>
</AccordionGroup>

## Troubleshooting

Be aware that some "User" reports are available only to Team or Enterprise edition accounts.
