Smartsheet Python SDK

Build Status Coverage Status PyPI version

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:

  1. 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.

  2. Install the Smartsheet Python SDK (see the installation instructions above)

  3. 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:

  1. Smartsheet Python SDK sample project
  2. Python SDK documentation
  3. Smartsheet API Documentation

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:

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for smartsheet-platform from gravatar.com smartsheet-platform

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.7

Provides Extra

develop docs packaging test

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smartsheet_python_sdk-4.4.0.tar.gz (93.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

smartsheet_python_sdk-4.4.0-py3-none-any.whl (270.8 kB view details)

Uploaded Python 3

File details

Details for the file smartsheet_python_sdk-4.4.0.tar.gz.

File metadata

  • Download URL: smartsheet_python_sdk-4.4.0.tar.gz
  • Upload date:
  • Size: 93.2 kB
  • Tags: Source
  • Uploaded using 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}

File hashes

Hashes for smartsheet_python_sdk-4.4.0.tar.gz
Algorithm Hash digest
SHA256 7ca910dd2dc23e4b1d2fbfe866e6945c261362819ce1679aa7e72cdb3ed9cead
MD5 e87f92b1ea688fc0e658baf8305a3340
BLAKE2b-256 4981ad5d91f50aa5a75265b488b6baa99fcd3b5ab406436d1cea9e221777c417

See more details on using hashes here.

File details

Details for the file smartsheet_python_sdk-4.4.0-py3-none-any.whl.

File metadata

  • Download URL: smartsheet_python_sdk-4.4.0-py3-none-any.whl
  • Upload date:
  • Size: 270.8 kB
  • Tags: Python 3
  • Uploaded using 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}

File hashes

Hashes for smartsheet_python_sdk-4.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2f82a9c2b93088cc046cddb6df1e13b9696739c7b6a6f65ed63dab531d5ca197
MD5 096b0d459c4019872f13ea9b6fb1189a
BLAKE2b-256 0dde1564c20b74e2e924e49a6cc2d2ac3213a3f14d7694f94f91bb9bdb73201f

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

4.4.0 This release

2 files

4.3.0

2 files

4.2.0

2 files

4.1.0

2 files

4.0.2

2 files

4.0.1

2 files

4.0.0

2 files

3.9.0

2 files

3.8.0

2 files

3.7.2

2 files

3.7.1

2 files

3.7.0

2 files

3.6.0

2 files

3.5.6

2 files

3.5.5

2 files

3.5.4

2 files

3.5.3

2 files

3.5.2

2 files

3.5.1

2 files

3.5.0

1 file

3.4.0

2 files

3.3.0

2 files

3.2.0

2 files

3.1.0

2 files

3.0.5

2 files

3.0.4

2 files

3.0.3

2 files

3.0.2

2 files

3.0.0

2 files

2.177.1

2 files

2.105.1

2 files

2.105.0

2 files

2.101.0

2 files

2.86.0

2 files

2.83.0

2 files

2.77.0

2 files

2.68.3

2 files

2.68.2

2 files

2.68.1

2 files

2.68.0

2 files

1.5.0

2 files

1.4.0

2 files

1.3.3

2 files

1.3.2

2 files

1.3.1

2 files

1.3.0

2 files

1.2.4

2 files

1.2.3

2 files

1.2.2

2 files

1.2.1

1 file

1.2.0

2 files

1.1.0

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page