# gt: General Translation CLI tool: gt project create
URL: https://generaltranslation.com/en-US/docs/cli/reference/commands/project-create.mdx
---

title: gt project create
description: Create a Project from the command line with an Organization API key. API reference for the gt project create command.

---

Use `gt project create` to provision a Project before a Project ID or Project-scoped API key exists.

## Overview [#overview]

```bash
npx gt project create \
  --name <name> \
  --default-locale <locale> \
  [options]
```

The command requires an Organization API key. Project keys cannot create Projects.

## How it works [#how-it-works]

1. Resolves the API key from `--api-key` or `GT_API_KEY`.
2. Standardizes the default locale.
3. Creates the Project in the Organization associated with the key.
4. Prints the created Project's name and ID.

The command exits with status 1 when credentials are missing, the key is not an Organization key, or the API rejects the request.

## Flags [#flags]

| Parameter | Description | Type | Optional | Default |
| --- | --- | --- | --- | --- |
| `--name <name>` | Project name. | `string` | No | — |
| `--default-locale <locale>` | Source locale for the Project. | `string` | No | — |
| `--cdn-enabled` | Enables CDN delivery for the Project. | `boolean` | Yes | `false` |
| `-c, --config <path>` | Path to `gt.config.json`. | `string` | Yes | Auto-resolved |
| `--api-key <key>` | Organization API key override. | `string` | Yes | `GT_API_KEY` |
| `--project-id <id>` | Shared Project ID override; not required for Project creation. | `string` | Yes | Config or `GT_PROJECT_ID` |

## Example [#example]

```bash
GT_API_KEY="gtx-org-..." npx gt project create \
  --name "Storefront" \
  --default-locale en \
  --cdn-enabled
```

The command prints the Project name and its new ID. Store that ID as `GT_PROJECT_ID` for later Project-scoped commands.

## Other notes [#notes]

- `gt project create` is available in `gt` 2.20.0 and later.
- The API key needs the `org:projects:create` permission.
- Enabling CDN delivery also requires the `project:write` permission.
- See [Create a Project](/docs/platform/openapi/reference/project/create-project) for the underlying endpoint contract.