Install Spark API:

$ sudo pip install ciscosparkapi

Make sure to export your Spark access token before running this recipe:

$ export SPARK_ACCESS_TOKEN="XXXX"

If your access token is incorrect, you will receive the following error message:

ciscosparkapi.exceptions.SparkApiError: Response Code [401] - Authentication credentials were missing or incorrect.

If you have not set the access token, the following message will be reported:

ciscosparkapi.exceptions.ciscosparkapiException: You must provide an Spark access token to interact with the Cisco Spark APIs, either via a SPARK_ACCESS_TOKEN environment variable or via the access_token argument.

You may copy your access token from the developer portal of Cisco Spark (https://developer.ciscospark.com/#).