Clockodo

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.