Skip to content
English
Go to Toggl Focus
  • There are no suggestions because the search field is empty.

Toggl Focus Public API

Toggl Focus has a public API that lets you build integrations, automate workflows, and connect it with external tools.

Overview

 You can use the API to interact with your tasks, time blocks, time entries, projects, and more — programmatically. To use the API, you need an API token. You generate this token from your profile settings, and then use it to authenticate your requests. Full API documentation — including available endpoints, request formats, and authentication details — is available at https://engineering.toggl.com/docs/focus/ under the Focus section.

Feature availability

Note: API rate limits and quotas depend on your subscription plan.

 
Plan Access
Free 30 requests / hour
Starter 240 requests/hour
Premium 600 requests/hour
Enterprise custom

 

How API authentication works

The Toggl Focus API uses bearer token authentication. Every request to the API must include your API token in the Authorization header.

Your API token is tied to your user account. Actions performed via the API are attributed to you — they appear in audit logs under your name, and permission checks are based on your role in the organization and workspace.

API tokens are hashed after generation — Toggl does not store your token in plain text. This means you can only see and copy your token once, right after generating it. If you lose it, you’ll need to generate a new one.

How to generate an API token

  1. Go to your Toggl account at toggl.com.
  2. Navigate to Profile Settings.
  3. Scroll to the API Token section.
    Bildschirmfoto 2026-03-19 um 15.17.13 (1)
  4. Select an expiration period (for example, 30 days).
  5. Click Generate.
  6. Copy the token immediately — it will not be shown again.

The expiration date is displayed next to your token. Once the token expires, you’ll need to generate a new one.

Things to keep in mind

  • One token at a time. You can have one active API token per user account.
  • Copy it when you see it. The token is shown only once after generation. If you lose it, generate a new one — the old one will be revoked.
  • Permissions follow your role. The API respects the same role-based permissions as the Toggl Focus app. If you can’t do something in the UI, you can’t do it via the API either.
  • Quotas apply. API usage counts toward your plan’s quota. If you hit the limit, requests will be throttled.

API documentation

For the full list of available endpoints, request and response formats, and code examples, visit the Toggl Focus API documentation.