---
title: "Add an user into workspace projects users"
method: POST
path: "/workspaces/{workspace_id}/project_users"
tags: ["projects"]
---

# Add an user into workspace projects users

`POST /workspaces/{workspace_id}/project_users`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/project_users`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/project_users/post.ts> (a function with typed inputs; its response is checked against the schema)

Include a project user for a given workspace.

## Path parameters

- `workspace_id` integer, required

## Request body

- UserPostPayload
  - `labour_cost` integer: Labour cost for this project user
  - `manager` boolean: Whether the user will be manager of the project
  - `project_id` integer: Project ID
  - `rate` number: Rate for this project user
  - `rate_change_mode` string: Rate change mode for this project user. Can be "start-today", "override-current", "override-all"
  - `use_last_labour_cost` boolean: Whether the last labour cost should be applied or not, default false
  - `user_id` integer: User ID

## Response `200`

Successful operation.

- ModelsProjectUser
  - `at` string: When was last modified
  - `gid` integer: Group ID, legacy field
  - `group_id` integer: Group ID
  - `id` integer: Project User ID
  - `labour_cost` integer: Labour cost for this project user
  - `manager` boolean: Whether the user is manager of the project
  - `project_id` integer: Project ID
  - `rate` number, nullable: Custom rate for project user
  - `rate_last_updated` string: Date for rate last updated
  - `user_id` integer: User ID
  - `workspace_id` integer: Workspace ID

## Other responses

- `400`: Possible error messages: * Workspace not found * Invalid project\_id * Invalid user\_id <* Project user already exists
- `403`: User does not have access to this resource.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)