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
- Payroll Systems: Export timesheet data for payroll processing
- Project Management: Sync time tracking with PM tools
- Invoicing: Generate invoices from tracked time
- Analytics: Build custom dashboards and reports
- Automation: Trigger actions based on time tracking events
- Mobile Apps: Build custom time tracking mobile applications
API Endpoints
Users & Workspaces
- GET /workspaces
- GET /workspaces//users
- PATCH /workspaces//users/
Time Entries
- GET /workspaces//time-entries
- POST /workspaces//time-entries
- PUT /workspaces//time-entries/
- DELETE /workspaces//time-entries/
Projects & Tasks
- GET /workspaces//projects
- POST /workspaces//projects
- GET /workspaces//projects//tasks
Reports
- POST /workspaces//reports/summary
- POST /workspaces//reports/detailed
- POST /workspaces//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
