Smartsheet Python SDK
A library for connecting to the Smartsheet API from Python applications.
Requirements
The SDK is compatible with actively supported Python versions 3.10, 3.9, 3.8, 3.7.
Installation
To install using pip:
pip install smartsheet-python-sdk
Getting Started
To get started with the Smartsheet Python SDK:
-
Set SMARTSHEET_ACCESS_TOKEN in your environment, using your Smartsheet API key. Find out more about Authentication and Access Tokens in the Smartsheet API Documentation. You can generate an access token in Smartsheet UI under Account > Personal Settings > API Access.
-
Install the Smartsheet Python SDK (see the installation instructions above)
-
The following snippet shows how to create a Smartsheet client and perform some basic actions using the SDK. Ensure your Smartsheet user has access to at least one sheet.
import smartsheet
smart = smartsheet.Smartsheet() # Create a Smartsheet client
response = smart.Sheets.list_sheets() # Call the list_sheets() function and store the response object
sheetId = response.data[0].id # Get the ID of the first sheet in the response
sheet = smart.Sheets.get_sheet(sheetId) # Load the sheet by using its ID
print(f"The sheet {sheet.name} has {sheet.total_row_count} rows") # Print information about the sheet
Documentation
Use the following resources to learn more about the SDK capabilities:
Contributing
We welcome contributions! Before submitting code changes, please review our Issue First approach for creating effective issues that work well with both human reviewers and AI-powered Cloud Agents. For additional contribution guidelines, see CONTRIBUTING.md.
Advanced Topics
For details about logging, testing, how to use a passthrough option, and how to override HTTP client behavior, see Advanced Topics.
Developer Agreement
Review the Developer Program Agreement.
Acknowledgements
We would like to thank the following people for their contributions to this project:
- Tim Wells - timwellswa
- Scott Wimer - happybob007
- Steve Weil - seweil
- Kevin Fansler - kfansler
- Nathan Armstrong - armstnp
1 maintainer
Release files for smartsheet-python-sdk 4.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| smartsheet_python_sdk-4.4.0.tar.gz | 93.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| smartsheet_python_sdk-4.4.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:364.0 kB
Release files / smartsheet_python_sdk-4.4.0.tar.gz
| Download URL | smartsheet_python_sdk-4.4.0.tar.gz |
|---|---|
| Size | 93.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7ca910dd2dc23e4b1d2fbfe866e6945c261362819ce1679aa7e72cdb3ed9cead
|
|
BLAKE2b-256 checksum How to use checksums |
4981ad5d91f50aa5a75265b488b6baa99fcd3b5ab406436d1cea9e221777c417
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / smartsheet_python_sdk-4.4.0-py3-none-any.whl
| Download URL | smartsheet_python_sdk-4.4.0-py3-none-any.whl |
|---|---|
| Size | 270.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2f82a9c2b93088cc046cddb6df1e13b9696739c7b6a6f65ed63dab531d5ca197
|
|
BLAKE2b-256 checksum How to use checksums |
0dde1564c20b74e2e924e49a6cc2d2ac3213a3f14d7694f94f91bb9bdb73201f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
