# Smartsheet Python SDK
[](https://github.com/smartsheet/smartsheet-python-sdk/actions/workflows/test-build.yaml) [](https://coveralls.io/github/smartsheet/smartsheet-python-sdk?branch=mainline) [](https://badge.fury.io/py/smartsheet-python-sdk)
A library for connecting to the [Smartsheet API](https://smartsheet.redoc.ly) from Python applications.
## Requirements
The SDK is compatible with [actively supported](https://devguide.python.org/versions/#versions) Python versions `3.10`, `3.9`, `3.8`, `3.7`.
## Installation
To install using [pip](http://www.pip-installer.org/):
```bash
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](https://smartsheet.redoc.ly/#section/API-Basics/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.
``` python
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](https://github.com/smartsheet-samples/python-read-write-sheet)
2. [Python SDK documentation](https://smartsheet.github.io/smartsheet-python-sdk/)
3. [Smartsheet API Documentation](https://smartsheet.redoc.ly)
## Advanced Topics
For details about logging, testing, how to use a passthrough option, and how to override HTTP client behavior,
see [Advanced Topics](ADVANCED.md).
## Developer Agreement
Review the [Developer Program Agreement](https://www.smartsheet.com/legal/developer-program-agreement).
## Acknowledgements
We would like to thank the following people for their contributions to this project:
* Tim Wells - [timwellswa](https://github.com/timwellswa)
* Scott Wimer - [happybob007](https://github.com/happybob007)
* Steve Weil - [seweil](https://github.com/seweil)
* Kevin Fansler - [kfansler](https://github.com/kfansler)
* Nathan Armstrong - [armstnp](https://github.com/armstnp)
Raw data
{
"_id": null,
"home_page": "http://smartsheet-platform.github.io/api-docs/",
"name": "smartsheet-python-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Smartsheet, Collaboration, Project Management, Excel, spreadsheet",
"author": "Smartsheet",
"author_email": "sdk@smartsheet.com",
"download_url": "https://files.pythonhosted.org/packages/06/fb/d5b9355f29b63af452b1633cc1212edc4f7f221caec23914254b349f45a6/smartsheet-python-sdk-3.1.0.tar.gz",
"platform": null,
"description": "# Smartsheet Python SDK\n\n[](https://github.com/smartsheet/smartsheet-python-sdk/actions/workflows/test-build.yaml) [](https://coveralls.io/github/smartsheet/smartsheet-python-sdk?branch=mainline) [](https://badge.fury.io/py/smartsheet-python-sdk)\n\nA library for connecting to the [Smartsheet API](https://smartsheet.redoc.ly) from Python applications.\n\n## Requirements\n\nThe SDK is compatible with [actively supported](https://devguide.python.org/versions/#versions) Python versions `3.10`, `3.9`, `3.8`, `3.7`.\n\n## Installation\n\nTo install using [pip](http://www.pip-installer.org/):\n\n```bash\npip install smartsheet-python-sdk\n```\n\n## Getting Started\n\nTo get started with the Smartsheet Python SDK:\n\n1. Set **SMARTSHEET_ACCESS_TOKEN** in your environment, using your Smartsheet API key. Find out more about [Authentication and Access Tokens](https://smartsheet.redoc.ly/#section/API-Basics/Authentication-and-Access-Tokens) in the Smartsheet API Documentation. You can generate an access token in Smartsheet UI under Account > Personal Settings > API Access.\n\n2. Install the Smartsheet Python SDK (see the installation instructions above)\n\n3. 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.\n\n``` python\n\nimport smartsheet\n\nsmart = smartsheet.Smartsheet() # Create a Smartsheet client \n\nresponse = smart.Sheets.list_sheets() # Call the list_sheets() function and store the response object\nsheetId = response.data[0].id # Get the ID of the first sheet in the response\nsheet = smart.Sheets.get_sheet(sheetId) # Load the sheet by using its ID\n\nprint(f\"The sheet {sheet.name} has {sheet.total_row_count} rows\") # Print information about the sheet\n```\n\n## Documentation\n\nUse the following resources to learn more about the SDK capabilities:\n\n1. [Smartsheet Python SDK sample project](https://github.com/smartsheet-samples/python-read-write-sheet)\n2. [Python SDK documentation](https://smartsheet.github.io/smartsheet-python-sdk/)\n3. [Smartsheet API Documentation](https://smartsheet.redoc.ly)\n\n## Advanced Topics\n\nFor details about logging, testing, how to use a passthrough option, and how to override HTTP client behavior,\nsee [Advanced Topics](ADVANCED.md).\n\n## Developer Agreement\n\nReview the [Developer Program Agreement](https://www.smartsheet.com/legal/developer-program-agreement).\n\n## Acknowledgements\n\nWe would like to thank the following people for their contributions to this project:\n\n* Tim Wells - [timwellswa](https://github.com/timwellswa)\n* Scott Wimer - [happybob007](https://github.com/happybob007)\n* Steve Weil - [seweil](https://github.com/seweil)\n* Kevin Fansler - [kfansler](https://github.com/kfansler)\n* Nathan Armstrong - [armstnp](https://github.com/armstnp)\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Library that uses Python to connect to Smartsheet services (using API 2.0).",
"version": "3.1.0",
"project_urls": {
"Homepage": "http://smartsheet-platform.github.io/api-docs/"
},
"split_keywords": [
"smartsheet",
" collaboration",
" project management",
" excel",
" spreadsheet"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ddc982fe3ea67961c1ed7300d40ece9a8cd81b585bf6e03533d9d7a0b38bd94b",
"md5": "9e9346a5ac7b40ac26bd2c088f7f7d03",
"sha256": "e42edcc6e29acf5985245910c46b1c2adf06d84f18e91db0dcdcbe7b97dd1111"
},
"downloads": -1,
"filename": "smartsheet_python_sdk-3.1.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "9e9346a5ac7b40ac26bd2c088f7f7d03",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 233746,
"upload_time": "2025-08-28T15:49:47",
"upload_time_iso_8601": "2025-08-28T15:49:47.943264Z",
"url": "https://files.pythonhosted.org/packages/dd/c9/82fe3ea67961c1ed7300d40ece9a8cd81b585bf6e03533d9d7a0b38bd94b/smartsheet_python_sdk-3.1.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "06fbd5b9355f29b63af452b1633cc1212edc4f7f221caec23914254b349f45a6",
"md5": "b36f5670c598e5e30a1248287d63062b",
"sha256": "1877e7f0b1726509079d330a3d3f1a3296c77ccceaf6ba0ee7b895aeb5a9a693"
},
"downloads": -1,
"filename": "smartsheet-python-sdk-3.1.0.tar.gz",
"has_sig": false,
"md5_digest": "b36f5670c598e5e30a1248287d63062b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 342433,
"upload_time": "2025-08-28T15:49:49",
"upload_time_iso_8601": "2025-08-28T15:49:49.587081Z",
"url": "https://files.pythonhosted.org/packages/06/fb/d5b9355f29b63af452b1633cc1212edc4f7f221caec23914254b349f45a6/smartsheet-python-sdk-3.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-28 15:49:49",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "smartsheet-python-sdk"
}
JSON