Clockodo
Clockodo is a time-tracking platform for businesses. This bundle provides full CRUD access to time entries, projects, customers, and absences, plus read-only access to leave balances, team structures, services, and workforce reports.
Entity Hierarchy
- Customers own Projects. Projects are the primary grouping for time entries.
- Users belong to Teams and log Entries (time records) against projects/services.
- Services and Lumpsum Services define billable work categories. Surcharges attach modifiers.
- Absences track leave (vacation, sick, etc.). Holidays Quota/Carry and Overtime Carry track balances per employee.
- Target Hours define expected weekly/monthly hours per user.
- Non Business Days are public holidays or company-wide days off.
CRUD Capabilities
Full CRUD (create, read, update, delete):
- Entries — create time entries with customer/service/time, update descriptions or billable status, delete wrong entries.
- Customers — create new clients, update names or billing defaults, delete inactive customers.
- Projects — create projects under customers, update status or notes, delete completed projects.
- Absences — create leave requests with type/dates, update notes or dates, delete cancelled leave.
Read-only:
- Users, Teams, Services, Lumpsum Services, Surcharges (organization config)
- Holiday Carry, Holiday Quota, Overtime Carry, Target Hours (balance data)
- Non-Business Days, User Reports, Work Times (reference/reporting)
Workflows
Log and audit time: Create entries with customer, service, and time range. Omit time_until to start a running timer. Paginate through large entry sets for auditing. Cross-reference with projects and customers for billing context.
Manage clients and projects: Create customers, then create projects under them. Update billable defaults or deactivate stale records.
Handle leave requests: Create absences with type (1=vacation, 2=special leave, 3=overtime reduction, 4=sick day). Check holiday quotas and carryover balances to validate remaining leave. Delete cancelled requests.
Understand org structure: List users and teams. To see which customers and projects a specific user can access, you need the user's ID first — fetch the users list, then query their customer/project access permissions.
Generate reports: User reports summarize activity across a period. Work times provide the raw hour-by-hour data.
Pagination
Customers, projects, services, and entries support pagination via page (cursor token) and items_per_page (default 1000). Other endpoints return all records in a single response.
Gotchas
- User ID dependency: Viewing a user's customer/project access requires their numeric user ID. Fetch the users list first.
- Absences require year: The absences list endpoint requires a year parameter.
- Entry creation requires IDs: Creating a time entry needs customers_id, services_id, and time_since. Fetch customers and services first to get valid IDs.
- German locale: Clockodo is Germany-focused; date formats and non-business days default to German conventions.
