Using API Keys to authenticate (Integration API)

What is the smenso Integration API?

The smenso Integration API is an application layer that allows other applications to read and update data of a smenso workspace, e.g. tasks can be created and updated this way and more.

Who can use the smenso Integration API?

Currently, all regular accounts (administrators, members, restricted members, viewers and guests) can use the smenso Integration API and have the possibility to create their personal API token.

Why use the smenso Integration API?

There are several use cases one can think of for the smenso Integration API, these include for example:

• Creating a new task in a smenso project when a record is created on another system (e.g. from an external form)
• Importing data from another source programmatically

Authentication with API token

Before starting to query a smenso account via the API, authentication via an access token (API Token) must be established. 

Each smenso account has the ability to create a personal API Token that grants API access to smenso data that this smenso account has access to according to their roles and permissions.

Creating an API token in the Admin Center

1. Open the Admin Center
2. Go to API Token
3. Choose Create API token
4. Choose the Workspace for which the API token should be applied and the Expiration time
5. Give the API token a name for better recognition
6. Confirm by clicking Create
   
   
   
   
7. In the next dialog: Copy and save all information in this dialog, as it will be displayed only once. After closing the dialog the information cannot be viewed again.
   
   
8. Closethe window

Now the API token is created and you can use it for authentication with third party applications.