# Track time in Toggl Track with a pipe

> Install the Toggl Track pipe with your API token, find your workspace ID, and move its time entry, project and client calls to Toggl's current API v9.

Source: https://tadabase.com/docs/pipes/toggl-track-pipe  
Status: Verified Nov 17, 2026. Checked against the current product

The **Toggl Track** pipe creates and manages time entries, projects and clients in Toggl Track from your app, for example to start a timer when a job begins or to add a Toggl client for each new customer.

> **The calls use Toggl's retired API v8:** Every call in this pipe points at `https://api.track.toggl.com/api/v8/...`. Toggl retired API v8 in 2022 in favor of v9, so the calls fail until you update them. Because the pipe is Configurable, you can do that yourself; see [Update a call to API v9](#update-to-v9).

## Install the pipe

1. **Copy your API token** In the Toggl Track web app, open your **Profile Settings** and scroll down to **API Token**. Reveal the token and copy it.
2. **Open the pipe** In the builder, click **Pipes** in the icon bar on the left, then click the **Toggl Track** card in **All Pipes**.
3. **Install it** Click **Install**. Paste the token into **API Token** and click **Install** again. The pipe opens on its **General** tab.
4. **Check the token** If you left **API Token** empty, click the **Global Parameters** tab, paste the token as its **Default Value** and click **Save**.

![The Toggl Track pipe opened from All Pipes, with the Install button and its list of available actions](https://tadabase.com/docs-shots/pipes-toggl-library.webp)

Toggl Track is a **Configurable** pipe: it is copied into your app, so you can change its calls. Each call signs in with basic authentication on its **Authorization** tab, with the token as the user name and `api_token` as the password.

## Find your workspace ID

Toggl Track keeps clients, projects and time entries inside a workspace, and most calls need its ID. In API v9, `GET https://api.track.toggl.com/api/v9/me` returns your `default_workspace_id`. Run it from a call's **Test** tab once you have updated the **Get Workspaces** or **Get Current User Data** call (see below), and copy the number.

If you always use the same workspace, enter its ID as the default value of the workspace ID parameter in each call, so you don't have to map it every time.

## Calls

| Area | Calls |
| --- | --- |
| Time entries | **Create a Time Entry**, **Start a Time Entry**, **Stop a Time Entry**, **Get Running Time Entry**, **Get Time Entry Details**, **Update a Time Entry**, **Delete a Time Entry**, **Get Time Entries Started in a Specific Time Range**, **Bulk Update Time Entry Tags** |
| Projects | **Create a Project**, **Get Project Data**, **Update Project Data**, **Delete a Project**, **Delete Multiple Projects**, **Get Project Tasks**, and calls for project users |
| Clients | **Create a New Client**, **Get Specific Client**, **Update a Specific Client**, **Delete a Client**, **Get Clients Visible to User**, **Get Client Projects** |
| Workspaces and account | **Get Workspaces**, **Get Single Workspace**, **Get Workspace Projects**, **Get Workspace Clients**, **Get Workspace Users**, **Get Current User Data**, and others |
| Other | Calls for tags, groups and tasks (tasks need a paid Toggl workspace) |

Open the **API Calls** tab to see every call with its parameters and response values.

## Update a call to API v9

In API v9 most addresses sit under the workspace, and request bodies are flat instead of wrapped in an object such as `time_entry`. Update only the calls you use, following Toggl's [API v9 documentation](https://engineering.toggl.com/docs/).

1. **Open the call** Click **Pipes**, open **Toggl Track**, click the **API Calls** tab and pick the call, for example **Start a Time Entry**.
2. **Add a workspace parameter** On the **Parameters** tab, add a parameter for the workspace ID if the call does not have one, and note its slug.
3. **Change the address** On the **Overview** tab, replace the URL with the v9 address, using the slug in braces, for example `https://api.track.toggl.com/api/v9/workspaces/{workspaceID}/time_entries`.
4. **Change the body** On the **Request** tab, rewrite the body in the v9 format. To start a running entry, v9 expects fields such as `created_with`, `workspace_id`, `project_id`, `description`, `start` and a negative `duration`.
5. **Test and map the response** On the **Test** tab, click **Test**. When it works, click **Populate Responses**, check the values on the **Response** tab and click **Save**.

## Example: create a Toggl client for each new customer

Once **Create a New Client** points at API v9, a workflow can keep Toggl in step with your Customers table. Add a **Toggl Client ID** text field to the table first.

1. **Start the workflow** Create a workflow on the Customers table with the **Record Created** trigger.
2. **Create the client** Add a **Trigger Pipe** step with **Toggl Track** > **Create a New Client**. Map the client name to the customer's name field and set the workspace ID.
3. **Save the ID** Add an **Update Record** step and set **Toggl Client ID** from **Step Data** > the Trigger Pipe step > the client ID value.

See [Run a pipe from a workflow](https://tadabase.com/docs/workflows/run-a-pipe-from-a-workflow) for how pipe steps and their response values work.

## Common problems

- **A call fails or returns an error page.** Check its URL on the **Overview** tab. If it contains `/api/v8/`, update it to v9 as above.
- **The call is refused as unauthorized.** Check **API Token** on the **Global Parameters** tab. Resetting the token in Toggl makes the old one stop working.
- **Task calls fail.** Toggl only offers tasks in paid workspaces.
