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

# Smartsheet

> Connect Smartsheet to Triggr with an API access token from a dedicated Smartsheet user.

Triggr works with Smartsheet sheets, rows, columns, workspaces, folders, reports, dashboards, users, groups and webhooks. You need a Business or Enterprise plan (or Advanced Work Management) on the standard Smartsheet service at `api.smartsheet.com`, not Smartsheet Gov or Smartsheet Regions.

## Set up Smartsheet

<Steps>
  <Step title="Choose the Triggr user">
    The token has the same access as its user, so use a shared service account. Share the sheets, workspaces, reports and dashboards your workflows touch with it; user actions need System Admin, and group actions need group administrator or System Admin.
  </Step>

  <Step title="Generate an access token">
    Signed in as that user, select **Account > Personal Settings > API Access > Generate new access token**. Name it `Triggr`, select OK and copy the token before you select OK again. Smartsheet shows it only once.
  </Step>
</Steps>

Tokens don't expire unless an Enterprise System Admin has set an expiry in Admin Center > Security & Control > API Access Token. See Smartsheet's [Generate an API access token](https://help.smartsheet.com/articles/2482389-generate-API-key).

## Connect it in Triggr

<Steps>
  <Step title="Open the configuration">
    Go to **Integrations > Smartsheet** and click **Configure** on the Base Configuration card.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/integrations-common/base-configuration.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=bb81acb082055015f91beda7b4876f35" alt="The Base Configuration card with Status Not Configured, Admin Consent Not Required and a Configure button." width="2272" height="330" data-path="images/integrations-common/base-configuration.png" />
    </Frame>
  </Step>

  <Step title="Enter the token">
    Paste the token, without a `Bearer` prefix, into Access Token and click Save Configuration.

    <Frame>
      <img src="https://mintcdn.com/triggr/nyuVXZ1rouDTTEvu/images/smartsheet/configure.png?fit=max&auto=format&n=nyuVXZ1rouDTTEvu&q=85&s=74f863c0b544583a9b36d9e21c0e101a" alt="The Smartsheet configuration window with an Access Token field, an Allow insecure TLS switch under Advanced, and a Save Configuration button." width="1344" height="898" data-path="images/smartsheet/configure.png" />
    </Frame>
  </Step>
</Steps>

Actions refer to items by numeric ID, such as `sheetId` or `columnId`. Get sheet returns a sheet's column and row IDs.

## Troubleshooting

<AccordionGroup>
  <Accordion title="401 Unauthorized (1002 or 1003)">
    `1003`: the token has expired. `1002`: check the token was pasted in full, is still listed under API Access, and its user is still active. Paste a new token into Access Token.
  </Accordion>

  <Accordion title="403 Forbidden (1004)">
    Share the item with the Triggr user, or give it System Admin (users) or group administrator (groups).
  </Accordion>

  <Accordion title="Deactivating or reactivating a user fails">
    Smartsheet refuses users on a public or non-plan email domain, users managed by an identity provider such as Microsoft Entra ID, and reactivations after 30 days or more.
  </Accordion>

  <Accordion title="429 (4003)">
    Smartsheet allows 300 requests a minute per token. Spread large workflows out or run them in smaller batches.
  </Accordion>
</AccordionGroup>


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