Timebutler provides an interface (API) with many features, including:
- Retrieve employee data
- Retrieve employee absence entries, working hours, vacation entitlement data, and working days
- Control the time clock for time tracking or import time entries
- Connect third-party hardware time-tracking terminals
- Download and modify projects and categories for time tracking
- Query personnel file data and payroll data
- and more..
This lets you automatically read out data from Timebutler and, for example, import it into third-party software such as Datev, SAP, or your ERP, generate emails, send notifications to employees, etc. To query the interface, you need to write (or have written) a program that calls the interface. An experienced developer can create a program within a few minutes that queries the standardized Timebutler interface.
An admin can enable or disable the Timebutler interface. You can enable or disable the interface for querying personnel file data and payroll data, and separately enable the interface for the remaining data. Access to the interface requires an individual API token. An admin user can generate the API token. There is one API token for querying personnel file and payroll data, and one API token for the remaining API endpoints. This lets you manage access to the two data types separately and grant separate access.
Enable or disable the API
To enable or disable the interface, sign in to Timebutler as an admin and then, on any page in Timebutler, click the “Interface (API)” link at the bottom in the footer area. There you can enable or disable the two interfaces, and you will also see the two API tokens there.
Your developer needs these two API tokens to be able to query the interface. Your developer also needs the [technical documentation of the API(/interface-api/technical-documentation/technical-documentation-for-the-api/).
The admin can generate a new API token at any time. This invalidates the old API token, so the old API token no longer grants access to the interface and data.