SmartSuite offers a variety of integration options, including direct integrations through the Automations function as well as more customized options through our Zapier connector and SmartSuite's REST API.
In order to interact with SmartSuite through Zapier or the API, you will need your API Key and your Workspace Id. This article will show you exactly how to get this information so that you can start integrating!
Note: Zapier logs in to SmartSuite using the user API Token that you provide. The Zap's access to data and its ability to add or change records is limited by the permissions granted to that member workspace. Pro-tip: create an Workspace that you use just for Zapier automations that has the fewest permissions necessary to accomplish your tasks to maximize your workspace security. |
You should treat your API token very carefully, as it functions just like your password to allow access to the system. Do not share it with other users, and we recommend that you only copy it from your API Key interface in SmartSuite when configuring your integration (in other words, don't store it in another location).
We'll also show you how to re-generate your API Key in case you feel the need to disable one that might have been accidentally shared.
Retrieving Your SmartSuite Workspace Id
Log in to your SmartSuite workspace here
Once logged in, look at the URL displayed in your browser
Your Workspace Id is the first 8 characters directly after https://app.smartsuite.com/
Retrieving Your SmartSuite API Key
Log in to your SmartSuite workspace here
Click on your user icon in the upper right corner of the SmartSuite interface
Select the "API Key" option
Your user profile will open and scroll to the API Key section
Click anywhere on the *** display to reveal your token
Double click on the token, then press CONTROL-C (or CMD-C on Mac) to copy it to your clipboard
Go paste the value into your Zapier workspace registration form
Regenerating Your SmartSuite API Key
If you ever feel like you want to invalidate an existing API Key, SmartSuite provides you that ability in the same interface used to retrieve your key. Warning: Once a token is regenerated the prior key value will immediately be invalid, so be prepared to update any systems that have it in use.
Follow these steps to re-generate your API Key:
Log in to your SmartSuite workspace here
Click on your user icon in the upper right corner of the SmartSuite interface
Select the "API Key" option
Your user profile will open and scroll to the API Key section
Click "Destroy Token"
Click "Generate New Key"
