> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# client.projects.create()

> Create a project.

Send a `teamId` and optional name. Returns the active project. Use a team where your API key has write access.

## Signature

Method signature on `client.projects`:

```ts theme={null}
create(args: {
  teamId: string;
  name?: string;
}): Promise<Project>;
```

## Parameters

**teamId** `string` *required*

The team that will own the project.

**name** `string`

Name of the project; defaults to `New Project`.

## Returns

`Promise<Project>`

A project: a team-scoped container for pipelines and datasets.

**id** `ProjectId` *required*

Project ID with prefix `pp.`.

**name** `string` *required*

Name of the project.

**teamId** `string` *required*

Identifier of the team that owns the project.

**status** `"draft" | "active"` *required*

Project state: `draft` before activation or `active` after activation.

**createdAt** `string` *required*

Time the project was created, as an ISO 8601 timestamp.

## Errors

HTTP errors throw [`PotatoApiError`](https://docs.platform.toloka.ai/docs/sdk/errors). The endpoint documents these error responses:

| Status | Description |
| - | - |
| 400 | The project request is invalid for the selected team. |
| 403 | Trial limit reached. An account that has not completed identity or business verification may hold one project and one pipeline, and cannot start a run. The body message reads "Your trial allows a single project. Verify your account to unlock full access." Complete verification in the web app to lift the limit. |
| 429 | Rate limit exceeded |

HTTP endpoint: [`POST /projects`](https://docs.platform.toloka.ai/docs/api-reference/projects/create-project).

```ts create() theme={null}
import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const project = await client.projects.create({
  teamId: "your-team-id",
  name: "Text labeling"
});
console.log(project);
```

```json create() theme={null}
{
  "id": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "teamId": "<string>",
  "status": "draft",
  "createdAt": "2026-01-01T00:00:00Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.