Tags

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 https://api.track.toggl.com/api/v9/workspaces/{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" \
  -X GET https://api.track.toggl.com/api/v9/me/tags

And the list of deleted tags with https://api.track.toggl.com/api/v9/me/tags/deleted.

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"}}' \
  -X POST https://api.track.toggl.com/api/v9/time_entries