# Projects Endpoints

**URL:** <https://community.toggl.com/t/projects-endpoints/156>\
**Category:** Getting Started With API\
**Tags:** projects, api, endpoints, documentation\
**Created:** [November 20, 2024, 6:04pm UTC](https://community.toggl.com/t/projects-endpoints/156 "2024-11-20T18:04:57Z")\
**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:04pm UTC](https://community.toggl.com/t/projects-endpoints/156/1 "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](https://support.toggl.com/en/articles/4200664-toggl-track-categorization-guide).

### Create a Project[​](https://engineering.toggl.com/docs/projects/#create-a-project)

Projects are specific to a workspace. You need to specify the `workspace_id` in order to interact with projects.

```auto
curl -u <email>:<password> \ -H "Content-Type: application/json" \ -d '{"active":true,"auto_estimates":false,"billable":true,"color":"#FFFFFF","currency":"EUR","estimated_hours":10,"is_private":false,"name":"Your project","template":false}' \ -X POST https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects

```

The project parameters are similar to the project details that you have specified when creating a project in the Toggl Track web app.

 ![Create Project](https://canada1.discourse-cdn.com/flex012/uploads/toggl1/original/1X/8c16a5238c06b061c8d8e36d6b68a35eaae8574f.png)

All the project properties are returned in the successful response.

### Get projects[​](https://engineering.toggl.com/docs/projects/#get-projects)

You can get the full list of projects by workspace:

```auto
curl -u <email>:<password> \ -H "Content-Type: application/json" \ -X GET https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects

```

Or the specific project by ID:

```auto
curl -u <email>:<password> \ -H "Content-Type: application/json" \ -X GET https://api.track.toggl.com/api/v9/workspaces/{workspace_id}/projects/{project_id}

```

It is also possible to fetch all users’ projects:

```auto
curl -u <email>:<password> \ -H "Content-Type: application/json" \ -X GET https://api.track.toggl.com/api/v9/me/projects

```

The full list can be paginated by adding `/paginated` to the endpoint. The request can also include `start_project_id` as the query parameter in order to provide an offset.

### Tracking for a project[​](https://engineering.toggl.com/docs/projects/#tracking-for-a-project)

As shown in the [Tracking page](https://engineering.toggl.com/docs/tracking/), a time entry that has been created can be associated to a project by specifying the `pid` parameter.

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

```