Toggl Api

REST API v9 at api.track.toggl.com/api/v9. Resources: time_entries, projects, clients, workspaces, tags, reports. POST /api/v9/workspaces/{id}/time_entries creates a time entry (start, stop, duration, project_id, tags). GET /api/v9/me/time_entries lists recent entries. Reports API at reports.api.track.toggl.com/api/v3 for detailed and summary views (filter by date, project, client, user). Response payloads are clean JSON. Pagination via since/page params. Dates in ISO 8601 format.

Standard HTTP status codes with plain text or JSON error bodies. 403 for insufficient permissions, 404 for missing resources, 429 for rate limit with Retry-After. Rate limits: 1 request/second per API token. Report endpoints have higher limits. Timer conflicts (overlapping entries) return 422 with descriptive error. Toggl maintains high uptime; status at status.toggl.com. Time entry validation is strict (start/stop must be consistent).

Toggl Track's API provides full programmatic access to time tracking data: creating/editing/deleting time entries, managing projects and clients, fetching detailed and summary reports, and managing workspace settings. For agents, the most useful capabilities are: logging time programmatically on behalf of users (productivity automation), generating project/client time reports for billing workflows, querying current timer status (is a timer running?), and bulk importing time data from external sources. Two API versions (v8 and v9); v9 is the current generation with more complete coverage. Clean REST design with good documentation. Confidence is docs-derived.

HTTP Basic Auth using either email:password or API_TOKEN:api_token (the string 'api_token' as the password with the token as username). API token available from Toggl Profile settings. Simple and reliable auth pattern — no OAuth2 required. Workspace-scoped endpoints; admin operations require workspace admin role. HTTPS enforced.

engineering.toggl.com/docs provides the complete API reference for both v8 and v9, including time entries, projects, clients, tags, and the Reports API. Documentation is developer-focused and thorough. Getting started requires a Toggl Track account (free tier available). API token is immediately accessible from the profile page. Postman collection available. Community support via help.toggl.com.