Get Started

Here's the quickest way to start using the Smartsheet API.

Generate an API access token

Generate an API access token in the Smartsheet UI.

1. Go to the Smartsheet UI.

2. Select your Account icon in the lower-left corner of the screen, and then select Personal Settings. The Personal Settings page for your account appears.

3. Select the API Access tab.

4. Click the Generate new access token button to generate an API access token.

   

5. Note your access token and store it in a secure location. See Access Token Best Practices.

Important: Smartsheet Gov, Smartsheet Regions Europe, and Smartsheet Regions Australia use different tokens from Smartsheet.com.

Call an API endpoint operation

You can call an operation right from within this documentation site.

1. Navigate to the page of an operation you want to call.

   For example, go to the List workspaces page.

2. Click the Try it button, under the example request code on the right side of the opertion page.

   

   A request editor appears.

   

3. Apply your API access token in the Security tab by selecting the Bearer Token value field and then selecting Set value to start replacing the current value.

   

4. In the Query tab, set or unset the operation's query parameters.

   

5. When you're ready to call the operation, click the Send button. A response appears in the Response tab, at the bottom left of the editor window.

   

You called the operation and received a response!

You can call other Smartsheet operations the same way, from within the Smartsheet API documentation site.