---
title: "projects create"
description: "Create a new project"
canonical: "https://pgbeam.com/docs/cli/projects/create"
last-updated: "2026-09-14T19:37:21.000Z"
---

# projects create

> Create a new project

URL: https://pgbeam.com/docs/cli/projects/create

Create a new PgBeam project in your organization. A project groups one or more database connections under a single proxy endpoint. Without flags, the command runs interactively and prompts for all required values including the upstream database connection details and SSL mode.

## Usage

## Options

Option

Description

Required

Default

`--name <value>`

Display name for the project

No

-

`--host <value>`

Hostname or IP address of the upstream PostgreSQL server

No

-

`--port <value>`

Port number of the upstream PostgreSQL server

No

`5432`

`--database <value>`

Name of the database on the upstream server

No

-

`--username <value>`

Username for authenticating with the upstream database

No

-

`--password <value>`

Password for authenticating with the upstream database

No

-

`--ssl-mode <value>`

SSL connection mode: disable, require, verify-ca, or verify-full

No

-

All global options (`--token`, `--profile`,
`--project`, `--org`, `--json`, `--no-color`, `--no-trunc`, `--debug`) are
also available on this command.

## Examples

## Output

Prints the new project ID, name, and database host. Suggests running `pgbeam link` as a next step. With `--json`, returns the full project and database objects.