# gt: General Translation CLI tool: gt project create
URL: https://generaltranslation.com/en-US/docs/cli/reference/commands/project-create.mdx
Docs index: https://generaltranslation.com/llms.txt
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 \
  --org-id <orgId> \
  --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 selected by `--org-id`.
4. Prints the created project's name and ID.

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

## Flags [#flags]

| Parameter | Description | Type | Optional | Default |
| --- | --- | --- | --- | --- |
| `--org-id <orgId>` | Organization that will own the project. | `string` | No | — |
| `--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 \
  --org-id "your-organization-id" \
  --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]

- The API key needs the `org:projects:create` permission.

### Version history

| Version | Changes |
| --- | --- |
| `2.21.1` | Added the required `--org-id` flag and moved project creation to `POST /v2/orgs/{orgId}/projects`. |
| `2.20.0` | Added `gt project create` using the now-removed `POST /v2/projects` route. |

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.