# Getting Started With API

**URL:** https://community.toggl.com/c/tech-discussions/getting-started-with-api/25.md

[Latest](https://community.toggl.com/latest.md) · [Categories](https://community.toggl.com/categories.md) · [Tags](https://community.toggl.com/tags.md)

---

## [About the Getting Started With API category](https://community.toggl.com/t/about-the-getting-started-with-api-category/410)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [December 2, 2024, 5:55pm UTC](https://community.toggl.com/t/about-the-getting-started-with-api-category/410 "2024-12-02T17:55:11Z")

</div>

This documentation focuses on current API v9 and the old v8 version will soon be deprecated. The documentation is already extended to Webhooks API and will soon be extended to missing services like Reports API v3. The d…

---

## [Open API](https://community.toggl.com/t/open-api/158)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 3\
**Last updated:** [November 8, 2025, 8:14am UTC](https://community.toggl.com/t/open-api/158 "2025-11-08T08:14:09Z")

</div>

:bulb: INFO Current format Swagger: 2.0. Notice that some files are still flagged with warnings on the official OpenAPI validator. Download the swagger files to generate your own client, you can find them below: Tog…

---

## [Authentication](https://community.toggl.com/t/authentication/152)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 3\
**Last updated:** [December 25, 2024, 11:17pm UTC](https://community.toggl.com/t/authentication/152 "2024-12-25T23:17:07Z")

</div>

To access the API, you must authenticate yourself. This can be done using either HTTP POST or HTTP Basic Auth. Once authentication is successful, a session is established through the use of a cookie. :grey\_exclamation: …

---

## [Tags Endpoints](https://community.toggl.com/t/tags-endpoints/157)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 6:07pm UTC](https://community.toggl.com/t/tags-endpoints/157 "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 o…

---

## [Projects Endpoints](https://community.toggl.com/t/projects-endpoints/156)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 6:04pm UTC](https://community.toggl.com/t/projects-endpoints/156 "2024-11-20T18:04:57Z")

</div>

Projects are a key component of how time entries are categorized in Toggl Track. If you want to explore all the ways you can categorize your time entries, check our Toggl Track Categorization Guide. Create a Project​ Pr…

---

## [Workspace Endpoints](https://community.toggl.com/t/workspace-endpoints/155)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 6:03pm UTC](https://community.toggl.com/t/workspace-endpoints/155 "2024-11-20T18:03:11Z")

</div>

Workspace Time entries belong to a specific workspace. When you sign up, a Default Workspace is automatically created. You can also sign up for a Toggl Track account via invitation into a workspace. As described in the O…

---

## [Organization Endpoints](https://community.toggl.com/t/organization-endpoints/154)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 6:01pm UTC](https://community.toggl.com/t/organization-endpoints/154 "2024-11-20T18:01:54Z")

</div>

An organization serves as a container for your workspaces. We will discuss workspaces in a separate topic. The Enterprise plan allows you to efficiently manage large teams across multiple workspaces within a single organ…

---

## [Tracking Time](https://community.toggl.com/t/tracking-time/153)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 5:50pm UTC](https://community.toggl.com/t/tracking-time/153 "2024-11-20T17:50:44Z")

</div>

Run a new time entry​ What are you waiting for? Start to track your time now! curl -u \<email\>:\<password\> \\ -H "Content-Type: application/json" \\ -d '{"created\_with":"API example code","description":"Hello Toggl","tags…

---

## [API Overview](https://community.toggl.com/t/api-overview/151)

<div class="topic-metadata">

**Author:** [@Support](https://community.toggl.com/u/Support)\
**Replies:** 0\
**Last updated:** [November 20, 2024, 4:52pm UTC](https://community.toggl.com/t/api-overview/151 "2024-11-20T16:52:47Z")

</div>

Overview This documentation focuses on current API v9 and the old v8 version will soon be deprecated. The documentation is already extended to Webhooks API and will soon be extended to missing services like Reports API v…
