Clockodo is a cloud-based time-tracking and project-management application used by agencies, service firms, and freelancers to record working hours, manage customers and projects, and report on absences and overtime. The Clockodo REST API exposes this data over authenticated HTTP endpoints, allowing Nexla to ingest time entries, users, projects, and related records for reporting and integration.
Power end-to-end data operations for your Clockodo API with Nexla. Our bi-directional Clockodo connector is purpose-built for Clockodo, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Clockodo or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Clockodo workflows fast, secure, and fully governed.
Features
Type: API
SourceDestination
Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
Request optimization with intelligent batching, retry, and caching to minimize API calls and costs
Before creating a Clockodo credential, you need your Clockodo account email address and an API key. The Clockodo API authenticates each request using the X-ClockodoApiUser header (your account email) and the X-ClockodoApiKey header (your API key). Nexla also sends the required X-Clockodo-External-Application identification header on your behalf.
To obtain your Clockodo API key, follow these steps:
Open the user menu and go to your personal settings. Each co-worker's API key is available in the Personal data section of their own account.
Locate the API key for your account, or generate a new API key if one does not already exist.
Copy the API key and note the email address associated with the account. These two values are required to authenticate with the Clockodo API.
Each co-worker has an individual API key that grants the same access rights as that user has in the Clockodo application. Treat the API key as a secret and keep it confidential. For complete information about API authentication and available endpoints, see the Clockodo REST API documentation.
After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.
Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.
Enter your Clockodo account email address in the Email Address field. This value is sent in the X-ClockodoApiUser header to identify your account.
Enter your Clockodo API key in the API Key field. This value is sent in the X-ClockodoApiKey header to authenticate your requests and must be kept confidential.
Each Clockodo API key grants the same access rights as the co-worker it belongs to. If your API key is compromised, generate a new key in your Clockodo account settings. For more information, see the Clockodo REST API documentation.
Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.
To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Clockodo connector tile, then select the credential that will be used to connect to Clockodo, and click Next; or, create a new Clockodo credential for use in this flow.
Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Clockodo endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.
List User Reports
This endpoint template retrieves user reports from your Clockodo account. Use this template when you need aggregated per-user report data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the userreports resource and returns them for ingestion into Nexla.
List Users
This endpoint template retrieves the list of users (co-workers) in your Clockodo account. Use this template when you need user records for analysis, reporting, or integration purposes.
This endpoint retrieves records from the users resource and returns them for ingestion into Nexla.
List Surcharges
This endpoint template retrieves surcharge records from your Clockodo account. Use this template when you need surcharge data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the surcharges resource and returns them for ingestion into Nexla.
List Customers
This endpoint template retrieves customer records from your Clockodo account. Use this template when you need customer data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the customers resource. Results are paginated, and Nexla automatically fetches subsequent pages until all records have been retrieved.
List Teams
This endpoint template retrieves team records from your Clockodo account. Use this template when you need team data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the teams resource and returns them for ingestion into Nexla.
List Customers Projects
This endpoint template retrieves the customer and project access permissions for a specific user in your Clockodo account. Use this template when you need to know which customers and projects a given user can access.
Enter the User ID of the user whose customer/project access permissions are retrieved. This required parameter identifies the user for the request.
This endpoint retrieves the customer/project access records for the specified user and returns them for ingestion into Nexla.
List Projects
This endpoint template retrieves project records from your Clockodo account. Use this template when you need project data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the projects resource. Results are paginated, and Nexla automatically fetches subsequent pages until all records have been retrieved.
List Absences
This endpoint template retrieves absence records from your Clockodo account. Use this template when you need absence data, such as vacation and sick leave, for analysis, reporting, or integration purposes.
This endpoint retrieves records from the absences resource and returns them for ingestion into Nexla.
List Entries
This endpoint template retrieves time entry records from your Clockodo account. Use this template when you need recorded working-time and booking data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the entries resource. Results are paginated, and Nexla automatically fetches subsequent pages until all records have been retrieved.
List Holidays Carry
This endpoint template retrieves holiday carryover records from your Clockodo account. Use this template when you need carried-over holiday balances for analysis, reporting, or integration purposes.
This endpoint retrieves records from the holidayscarry resource and returns them for ingestion into Nexla.
List Holidays Quota
This endpoint template retrieves holiday quota records from your Clockodo account. Use this template when you need per-user holiday entitlements for analysis, reporting, or integration purposes.
This endpoint retrieves records from the holidaysquota resource and returns them for ingestion into Nexla.
List Lumpsum Services
This endpoint template retrieves lump-sum service records from your Clockodo account. Use this template when you need lump-sum (flat-rate) service data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the lumpSumServices resource and returns them for ingestion into Nexla.
List Non Business Days
This endpoint template retrieves non-business day records from your Clockodo account. Use this template when you need public holiday and non-working-day data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the nonbusinessdays resource and returns them for ingestion into Nexla.
List Overtime Carry
This endpoint template retrieves overtime carryover records from your Clockodo account. Use this template when you need carried-over overtime balances for analysis, reporting, or integration purposes.
This endpoint retrieves records from the overtimecarry resource and returns them for ingestion into Nexla.
List Services
This endpoint template retrieves service records from your Clockodo account. Use this template when you need the catalog of services used for time tracking, for analysis, reporting, or integration purposes.
This endpoint retrieves records from the services resource. Results are paginated, and Nexla automatically fetches subsequent pages until all records have been retrieved.
List Target Hours
This endpoint template retrieves target hours records from your Clockodo account. Use this template when you need per-user contracted or target working-hour data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the targethours resource and returns them for ingestion into Nexla.
List Work Times
This endpoint template retrieves work time records from your Clockodo account. Use this template when you need per-day working-time data for analysis, reporting, or integration purposes.
This endpoint retrieves records from the workTimes resource. Results are paginated, and Nexla automatically fetches subsequent pages until all records have been retrieved.
Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.
Clockodo data sources can also be manually configured to ingest data from any valid Clockodo API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.
Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Clockodo data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.
