# Smartsheet setup for PopMCP You paste one value into PopMCP: a Smartsheet API access token, generated in Smartsheet under Account, Personal settings, API access. PopMCP finds your region (US, Europe, Australia or Gov) by itself. - Auth: API credentials - Setup time: 2 min - API base URL: https://api.smartsheet.com/2.0 - Credentials screen: https://app.smartsheet.com/ - Provider docs: https://help.smartsheet.com/articles/2482389-generate-API-key ## Approval required before this works No one reviews you, but Smartsheet restricts its API to Business and Enterprise plans (Advanced Work Management includes it too). Pro accounts cannot use the API, so a token from them does not work. - Typical wait: None. On an eligible plan the token is generated and works in under a minute. - Cost: Per smartsheet.com/pricing: Business is $19 per member a month billed yearly or $24 billed monthly; Enterprise and Advanced Work Management are priced by sales. Pro ($9 yearly, $12 monthly) does not include the API. A 30-day free trial needs no card. - Blocked until approved: Everything. Without a Business or Enterprise plan Smartsheet refuses API calls, so the connection cannot be made. - Works meanwhile: Start the 30-day free trial and generate a token right away; you can connect and try every tool before deciding on a plan. ## Before you begin - A Smartsheet account on a Business or Enterprise plan (or Advanced Work Management). Smartsheet does not allow API access on Pro - API access turned on for your user. It is on by default; a System Admin can turn it off in Admin Center - The sheets, reports and workspaces you want the AI to use must be shared with your user. A token reaches exactly what you can open ## Get your credentials ### 1. Sign in to Smartsheet Sign in to Smartsheet as the user whose sheets the AI should work with. If your company uses Smartsheet in Europe (app.smartsheet.eu), Australia (app.smartsheet.au) or Smartsheet Gov, sign in there: tokens only work in the region that issued them, and PopMCP finds the region for you. Screen: https://app.smartsheet.com/ ### 2. Open Personal settings, then API access At the bottom of the left navigation bar select Account (your profile picture), then Personal settings. In the window that opens, select the API access tab. Screen: https://app.smartsheet.com/ ### 3. Generate a token named PopMCP Select Generate new access token, name it PopMCP so you can recognise and revoke it later, and select OK. Screen: https://app.smartsheet.com/ ### 4. Copy the token right away Smartsheet shows the token once. Copy it now and keep it somewhere safe until you have pasted it into PopMCP, then select OK. The new token appears by name under Manage API Access Tokens. If you lose it, generate another one. Screen: https://app.smartsheet.com/ ### 5. Paste the token into PopMCP In PopMCP, paste the token into API access token and connect. PopMCP tries it on Smartsheet's US, Europe, Australia and Gov servers, keeps the region that accepts it, and reads your name and email to label the connection. ## Fields PopMCP asks for - API access token (accessToken) [required]: In Smartsheet: Account (your picture, bottom left), Personal settings, API access, Generate new access token. Name it PopMCP, then copy it right away: Smartsheet shows it only once. Works for Smartsheet in the US, Europe, Australia and Gov. ## Verify PopMCP marks the Smartsheet connection Verified under your name and email, and notes your region (for example Smartsheet Regions Europe). Asking the AI to find a sheet by name returns its id, and asking for its overdue rows reads them by column name. ## Troubleshooting ### "Smartsheet did not accept this API access token in any region (US, Europe, Australia or Gov)." Cause: The token was copied incompletely, has extra text around it, was revoked, or expired under an admin's token expiry rule. Fix: Generate a new token under **Account**, **Personal settings**, **API access** and paste only the token itself. ### "Smartsheet only allows API access on Business and Enterprise plans" Cause: The account is on Pro, which does not include the Smartsheet API. Fix: Use an account on Business or Enterprise, or start a free trial of one of those plans. ### "Smartsheet says this account must sign in with single sign-on" Cause: Your organization requires single sign-on and has not allowed API access for your user. Fix: Ask your Smartsheet System Admin to allow API access for your account, then generate a new token. ### "Smartsheet accepted the token but refused to read your profile." Cause: A System Admin turned off API access for your user or your organization. Fix: Ask your System Admin to turn API access back on in Admin Center, then connect again. ### Tools fail with 429 Cause: Smartsheet allows 300 requests a minute per token, and 30 a minute for file uploads and cell history. Fix: Wait a minute and retry. PopMCP already retries a rate-limited call once Smartsheet says when. ### Search does not find a sheet you just made Cause: Smartsheet's search index can take a while to include new items, and longer for an account that has not used the API lately. Fix: Ask the AI to use smartsheet_find, which falls back to listing your sheets, reports, dashboards and workspaces by name. --- Source: https://www.docs.popmcp.com/docs/integrations/smartsheet/