A library for connecting to the Smartsheet API from Python applications.

The SDK is compatible with actively supported Python versions 3.10, 3.9, 3.8, 3.7.

To install using pip:

pip install smartsheet-python-sdk

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

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

For details about logging, testing, how to use a passthrough option, and how to override HTTP client behavior, see Advanced Topics.

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