---
title: "Add user to a workspace"
method: POST
path: "/v1/workspaces/{workspaceId}/users"
tags: ["Workspace"]
---

# Add user to a workspace

`POST /v1/workspaces/{workspaceId}/users`

You can add users to a workspace via API only if that workspace has a paid subscription. If the workspace has a paid subscription, you can add as many users as you want but you are limited by the number of paid user seats on that workspace.

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `send-email` string, required

## Request body

- AddUserToWorkspaceRequest
  - `email` string, required — Represents an email address of the user.

## Response `200`

OK

- WorkspaceDtoV1 — unresolved $ref

## Changes

- **2026-08-20** `a5b636acbcd8` — 49 info
  - the `email` request property default value `` was added
  - the `` response's property default value `` was added for the status `200`
  - the `` response's property default value `` was added for the status `200`
  - the `` response's property default value `` was added for the status `200`
  - …45 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/users/post.md)

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)