# Tags Endpoints

**URL:** <https://community.toggl.com/t/tags-endpoints/157>\
**Category:** Getting Started With API\
**Tags:** api, endpoints, documentation, tags\
**Created:** [November 20, 2024, 6:07pm UTC](https://community.toggl.com/t/tags-endpoints/157 "2024-11-20T18:07:32Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Support](https://yyz2.discourse-cdn.com/flex012/user_avatar/community.toggl.com/support/32/1577_2.png) [@Support](https://community.toggl.com/u/Support)\
**Post date:** [November 20, 2024, 6:07pm UTC](https://community.toggl.com/t/tags-endpoints/157/1 "2024-11-20T18:07:33Z")

</div>

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](https://support.toggl.com/en/articles/4200664-toggl-track-categorization-guide).

### Create a Tag[​](https://engineering.toggl.com/docs/tags/#create-a-tag)

As discussed in the [Projects page](https://engineering.toggl.com/docs/projects/), tags are also workspace-related, although their structure is much simpler.

```auto
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[​](https://engineering.toggl.com/docs/tags/#get-tags)

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

```auto
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[​](https://engineering.toggl.com/docs/tags/#tag-time-entries)

You can attach multiple tags to a time entry as already shown in [Tracking page](https://engineering.toggl.com/docs/tracking/).

```auto
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

```