Skip to main content


You can add additional information to your time entries by using tags. Tags are basically labels that you can attach to your time entries. If you want to explore all the ways you can categorize your time entries, check out our Toggl Track Categorization Guide.

Create a Tag

As discussed in the Projects page, tags are also workspace-related, although their structure is much simpler.

curl -u <email>:<password> \
-H "Content-Type: application/json" \
-d '{"name":"Your Tag","workspace_id":workspace_id}' \
-X POST{workspace_id}/tags

Get tags

You can retrieve the full list of tags of a user:

curl -u <email>:<password> \
-H "Content-Type: application/json" \

And the list of deleted tags with

Tag time entries

You can attach multiple tags to a time entry as already shown in Tracking page.

curl -u <email>:<password> \
-H "Content-Type: application/json" \
-d '{"time_entry":{"description":"Hello Toggl","tags":["billed"],"pid":123,"created_with":"curl"}}' \
© 2024 Toggl. All rights reserved.