Clockify

Prerequisites

To connect Clockify to Omnata, you need to have an active Clockify account.

Authentication

API Key Authentication

The Clockify API uses token-based authentication.

Setting up and API Key

Follow the Clockify Authentication Documentation

• Login to your Clockify account

• Click on your avatar/profile picture in the top right corner

• Select 'Preferences'

• Go to the 'Advanced' tab

• Click 'Generate'

• Copy your API token.

Please note that you can always regenerate a new token; however, doing so will cause the previous token to expire.

Selecting the Regional Prefix

If your workspace is in a specific region, you need to include the regional prefix in the API URL. The regional prefix is the first part of the API URL. For example, if your API URL is https://apse2.clockify.me/api/v1, the regional prefix is apse2.

Below are the available regional server prefixes:

• EU (Germany): euc1

• USA: use2

• UK: euw2

• AU: apse2

Inbound Syncs

The Clockify API does not support incremental syncs on all objects (streams).

The following entities are available for incremental syncs:

• Approval Requests (Approved, Withdrawn Approval)

• Assignments

• Time Entries

The following entities are available for inbound syncs for full refresh:

• Clients

• Groups

• Tags

• Workspaces

• Users

• Holidays

• Policies

• Custom Fields

• Projects

• Expenses

• Expense Categories

• Invoices

• Tasks

• Approval Requests (Pending)

Outbound Syncs

There is currently no Outbound syncing support for this App, but please let us know if you have a use case in mind.