Clockify API

Overview

Clockify API Documentation provides comprehensive RESTful API access for developers to integrate Clockify's time tracking features into their applications and workflows. The API includes webhook support for real-time event notifications.

API Features

Core Capabilities

• Create, read, update, and delete time entries
• Manage projects, tasks, and clients
• Access user and workspace data
• Generate reports programmatically
• Manage tags and custom fields
• Control user permissions

Authentication

• API key-based authentication
• X-Api-Key header for requests
• X-Addon-Token for addon integrations
• Workspace-level access control

Webhooks

Real-Time Event Notifications

Clockify webhooks provide real-time notifications when events occur:

• Timer started
• Timer stopped
• Time entry created
• Time entry updated
• Time entry deleted
• Project created/modified

Webhook Configuration

• Workspace admins can create up to 10 webhooks each
• Maximum 100 webhooks per workspace
• Custom payload URLs
• Event filtering
• Signature verification for security

Rate Limiting

API Limits

• Standard requests: 50 requests per second
• Addon token requests: 50 requests per second
• Rate limit headers included in responses
• Automatic retry-after suggestions

Best Practices

• Implement exponential backoff
• Cache frequently accessed data
• Use bulk operations when available
• Monitor rate limit headers

Common Use Cases

Integration Scenarios

1. Payroll Systems: Export timesheet data for payroll processing
2. Project Management: Sync time tracking with PM tools
3. Invoicing: Generate invoices from tracked time
4. Analytics: Build custom dashboards and reports
5. Automation: Trigger actions based on time tracking events
6. Mobile Apps: Build custom time tracking mobile applications

API Endpoints

Users & Workspaces

• GET /workspaces
• GET /workspaces/{workspaceId}/users
• PATCH /workspaces/{workspaceId}/users/{userId}

Time Entries

• GET /workspaces/{workspaceId}/time-entries
• POST /workspaces/{workspaceId}/time-entries
• PUT /workspaces/{workspaceId}/time-entries/{id}
• DELETE /workspaces/{workspaceId}/time-entries/{id}

Projects & Tasks

• GET /workspaces/{workspaceId}/projects
• POST /workspaces/{workspaceId}/projects
• GET /workspaces/{workspaceId}/projects/{projectId}/tasks

Reports

• POST /workspaces/{workspaceId}/reports/summary
• POST /workspaces/{workspaceId}/reports/detailed
• POST /workspaces/{workspaceId}/reports/weekly

Response Format

JSON responses with standard structure:

{
  "id": "string",
  "description": "string",
  "projectId": "string",
  "timeInterval": {
    "start": "2026-03-16T10:00:00Z",
    "end": "2026-03-16T11:30:00Z"
  }
}

SDK & Libraries

Official and community SDKs available for:

• JavaScript/Node.js
• Python
• PHP
• C#/.NET
• Ruby
• Go

Documentation

Comprehensive documentation includes:

• Interactive API explorer
• Code examples in multiple languages
• Webhook setup guides
• Authentication tutorials
• Error code reference
• Changelog for API updates

Security

• HTTPS required for all requests
• API key rotation support
• Webhook signature verification
• IP whitelisting (Enterprise)
• Audit logs for API activity

Enterprise Features

• Higher rate limits
• Dedicated support
• SLA guarantees
• Custom webhook limits
• Priority API access