Library that uses Python to connect to Smartsheet services (using API 2.0).
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file smartsheet_python_sdk-4.2.0.tar.gz.
File metadata
- Download URL: smartsheet_python_sdk-4.2.0.tar.gz
- Upload date:
- Size: 92.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b07335d7e91899acbaab10ff9f21e6f6f189431f04481fea40cc991bf2084908
|
|
| MD5 |
2410c4a67375675e54804bfda8cd6bc6
|
|
| BLAKE2b-256 |
f7b369fff36307ff908c3da91e546cd42fb2997fe595f204315f20b0bc689c35
|
File details
Details for the file smartsheet_python_sdk-4.2.0-py3-none-any.whl.
File metadata
- Download URL: smartsheet_python_sdk-4.2.0-py3-none-any.whl
- Upload date:
- Size: 268.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64e03a093d3688ae3739c76b2bf99188af643b9e94da222a85e0d4b766279470
|
|
| MD5 |
c42b5aeb9b5aac9348bf8f54d4abd7db
|
|
| BLAKE2b-256 |
000ad22e05fe8608b2830f66c7c0fc1c1d22a0f5cc249265bb2befaa882596aa
|
