If you want to create data sources for custom Klips, you're in the right place.
If you're using PowerMetrics and want to create data sources for custom metrics, go here.
Visualize, discover, and act on your data with Klips and Klip dashboards.
Ready to get the most from your Smartsheet project management data? Get started by setting up a connection between Klipfolio and your Smartsheet data and adding some data sources.
When you're finished adding Smartsheet data sources, you'll use them to power your custom Klips.
This article includes:
- Authentication requirements - Your Smartsheet Access Token
- Finding your Sheet ID
- Adding a pre-built or custom Smartsheet data source
- Adjusting your query to return data in JSON format (optional)
- Additional information and tips
- I've added Smartsheet data sources - What's next?
Authentication requirements - Your Smartsheet Access Token
You authenticate with Smartsheet using an API Key. To do this, you need to enter your Smartsheet Access Token into Klipfolio. If you don't have an Access Token, learn how to generate one here: Authentication and Access Tokens.
When adding your pre-built or custom data source, you'll enter your Smartsheet Access Token, in the Configure your connection page as a header using the following format:
- Under Name, type Authorization.
- Under Value, enter your API Token in the following format: Bearer <yourAccessToken>, replacing the placeholder text with the Access Token from your Smartsheet account.
- Under Type, select Header from the drop-down list.
Finding your Sheet ID
When adding your Smartsheet data source, you'll need to enter your Sheet ID.
To find your Smartsheet Sheet ID:
- Go to the specific sheet that you want to get data from in your Smartsheet account.
- On the left side menu, select the Sheet Actions icon.
- Select Properties.
- Copy the Sheet ID.
Adding a pre-built or custom Smartsheet data source
To create a pre-built or custom data source using Smartsheet:
- Go to the Service Connectors page in Klipfolio and select Smartsheet from the list of connectors.
- On the Choose a pre-built or custom connection page, select either a pre-built or custom data source option.
- On the Configure your connection page, at Query URL, enter a Smartsheet URL endpoint. For example:
https://api.smartsheet.com/2.0/sheets/
Note: The Query URL field is auto-filled for you (remember to replace the placeholder text <yourSheetNumber> with your own sheet number).
There are many Smartsheet query options you can use to retrieve data. Refer to the Smartsheet API Documentation for more details. - At Data Format, select Excel.
- At Method, select GET.
- Expand the Query Parameters menu.
- At Parameters, under Name, type Accept.
- Under Value, type application/vnd.ms-excel.
- Under Type, select Header.
- When you're finished, click Get data.
- Ensure this is the data you’re looking for and, optionally, select the checkbox to Model your data. Learn more about modelling your data source.
- Click Continue.
- Name, choose refresh settings, and, optionally, share your data source.
- Click Save.
See below for an example of a Smartsheet data source setup.
The data source is added to your account and is ready to use for custom Klips. You can see all your data sources in your Data Source Library, accessed by clicking Data Sources in the left navigation sidebar.
Adjusting your query to return data in JSON format (optional)
Although it is easier to work with Smartsheet data in Excel format, you can adjust your query to return data in JSON format.
To do this, you must specify the following settings:
- Data Format = JSON.
- Parameter settings: Name = Accept, Value = application/json, and Type = Header.
Additional information and tips
Data Source Type |
Web Accessible Resource |
API Documentation |
|
API Limits |
By default, most endpoints return a maximum of 100 records per query. To retrieve all records, append the includeAll=true parameter to your query. |
Pagination Method |
Index endpoints (typically those that return lists of objects such as sheets and folders) return a maximum of 100 records per query and support pagination to return more records. To page through the data, use the pageSize and page parameters in your Smartsheet query. Responses provide totalPages and totalCount values to indicate the total numbers of pages and records, as well as pageNumber and pageSize values. This data can be used in pagination formulas. Refer to Data Sources with Multiple Pages for details on how to handle pagination. |
Date Parameters |
Default format: yyyy-MM-dd Append the numericDates parameter your query to return dates in Unix time format (milliseconds). |
Smartsheet Reports | To query Smartsheet reports, you'll need your Report ID. You can find it by running the endpoint /reports/ in a query in Klipfolio, or you can find your report ID in your Smartsheet account properties. |
Sample Queries |
Sheets
Folders
Contacts |
Next steps
Great! You've connected to your Smartsheet data and created one (or more) data sources. Now you're ready to use those data sources in custom Klips.
Want to learn more?
Check out these related articles: