Artisan IMG > Everhour (everhour) (d5beb4ff-73d1-4cd9-89fa-e36f50c58db5)

Everhour
1.0

Everhour is a time tracker that integrates with work management platforms.

Overview
Copy

Everhour is a time-tracking platform that integrates with a number of work management systems (including Jira, Asana, Trello, and more), in order to make invoicing and payroll easier.

Authentication
Copy

To begin using the connector, add an Everhour connector step to your workflow.

With the connector step highlighted, click on the 'New authentication' button that should now be visible in the Properties panel (under 'SETTINGS') on the right hand side:

In order to authenticate, you need an 'API Key'. You can retrieve your API key from the Everhour web app by going to 'My Profile'. Click on your icon, and the option should appear.

Within your Settings page, scroll all the way down to the bottom, where you will find a section called 'Application Access', which is where your API token will be hosted:

Copy said token and enter your key into the 'API Key' field inside the authentication window:

Once you have clicked the 'Add authentication' button, go to back to your authentication field (within the workflow dashboard properties panel from earlier), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Available Operations
Copy

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Example usage
Copy

Below is a brief example which demonstrates how to iterate through the projects stored in your Everhour account, and retrieve the tasks belonging to each.

TRAY POTENTIAL: Tray.io is extremely flexible. By design there is no fixed way of working with it - you can pull whatever data you need from other services and work with it using our core and helper connectors. This demo which follows shows only one possible way of working with Tray.io and the Everhour connector. Once you've finished working through this example please see our Introduction to working with data and jsonpaths page and Data Guide for more details.

The steps are outlined as follows:

  1. Set up your manual trigger and first Everhour connector step to list projects available.

  2. Add a Loop connector to iterate through your projects list.

  3. Add a step to get the tasks belonging to each project.

The end result should look something like this:

1 - Setup trigger & List projects
Copy

Once you have clicked 'Create new workflow' on your main Tray.io dashboard (and named said new workflow), select the Manual trigger from the trigger options available:

Once you have been redirected to the Tray.io workflow dashboard, from the connectors panel on the left, add a Everhour connector to your second step. Set the operation to 'List projects''.

The only field that is mandatory in this operation is 'Limit', but as it is already pre-filled for you, you need not worry about it at this stage.

You can also filter the operation to only retrieve projects that match a specific query using the 'Search query' field, or project which belong to a particular integration using the 'Platform' field.

Feel free to name your step to make things clearer for yourself and other users.

Now, when this workflow is run, it will pull down a list of projects from the Everhour API. This means you will be able to view them when you click through your debug panel, and expend the output field.

2 - Add a Loop step
Copy

Next, we add a Loop Collection connector to the workflow. Set the operation to 'Loop list'.

Use the connector-snake to generate the jsonpath you will need, by clicking and dragging on the orange circle mapping icon, left of the 'List operation' itself.

CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray, please see our pages on Basic data concepts and Mapping data between steps

Once you have dragged it over to the first Everhour step, you will see a dropdown list of options appear. Select the results array.

The Loop input panel should then look something like this:

This will enable us to iterate over the list of projects, and perform operations for each one, during each loop cycle.

3 - Get client
Copy

Finally, drag another Everhour connector step into the Loop collection itself, and select the operation 'List project tasks'.

Use the same connector-snake method for generating the jsonpath once more, only this time it is to get the 'ID' field.

From here, you can send the data from each project to another online service, manipulate the data in some way, or add another Loop collection to get each task individually.

BEST PRACTICES: Whenever you do decide to create your own workflow, be sure to check out some of our key articles such as: