This article provides a step-by-step guide on integrating Tines, an automation platform, with your Canary management Console. It explains the setup process, and how to establish a secure connection between Tines and the Canary Console. The article uses a basic example of listing your Canaries, to demonstrate how to implement the integration.

Note: This article also assumes that a Tines account has already been set up.

Step 1: Configure a Canary Console API key 

Head over to your Canary management Console and create an API key. This API key will be used to query your Canary Console and to build your automation/story within Tines. Take note of the value in the "Auth Token" field.

Step 2: Import a Thinkst Canary template into your Tines story

Select Templates and search for Thinkst Canary. Thereafter, drag and drop the Thinkst Canary Icon into your Tines story. Search for the action/api call which you wish to perform. In this example, we'll querying the Canary Console for all birds. 

Step 3: Add your Canary API key into a Tines credential object

On the right hand pane within your story, click on "Connect" and "Create credential". Thereafter select the "Text" based option. Within the value field of the text based option, specify the API key created in Step 1.

Within the credential it's also possible to configure a domain restriction. The will ensure that the API key is only used to query the Canary management Console.
Once configured, hit the save button. 

Step 4: Add your Console domain into a Tines resource object

On the right hand pane within your story, click on "Add" and "Create resource". Specify your Canary Console domain hash and hit save.

Step 5: Run your automation/query

Hit the run button, and observe the output from automation/query within the events field.

That's it, you're done ;-)