v1
latestOpenAPI 3.0.3Proprietary2026-07-26162247330.6 KBProject
Create project
Creates a Neon project within an organization. If using a personal API key, include the org_id parameter to specify which organization to create the project in. If using an org API key, org_id is automatically inferred from the key. Plan limits define how many projects you can create. For more information, see Manage projects.
You can specify a region and Postgres version in the request body. Neon currently supports PostgreSQL 14, 15, 16, 17, and 18. For supported regions and region_id values, see Regions.
post/projects
Request body
Example request
{
"project": {
"branch": {
"annotations": {
"github-commit-ref": "github-branch-name"
}
}
}
}Response
Created a project. The project includes a connection URI with a database, password, and role. At least one non-protected role is created with a password. Wait until the operations are finished before attempting to connect to a project database.
Example response
{
"project": {
"id": "spring-example-302709",
"platform_id": "aws",
"region_id": "aws-us-east-2",
"name": "spring-example-302709",
"provisioner": "k8s-pod",
"pg_version": 15,
"proxy_host": "us-east-2.aws.neon.tech",
"store_passwords": true,
"creation_source": "console",
"history_retention_seconds": 604800,
"created_at": "2022-12-13T01:30:55Z",
"updated_at": "2022-12-13T01:30:55Z",
"owner": {
"name": "John Smith",
"email": "some@email.com",
"branches_limit": 10,
"subscription_type": "scale"
},
"org_id": "org-morning-bread-81040908",
"owner_id": "629982cc-de05-43db-ae16-28f2399c4910",
"data_storage_bytes_hour": 2831928,
"branch_logical_size_limit": 10,
"branch_logical_size_limit_bytes": 10485760,
"data_transfer_bytes": 1000,
"written_data_bytes": 193990002,
"compute_time_seconds": 2485760,
"active_time_seconds": 621440,
"cpu_used_sec": 155350,
"consumption_period_start": "2022-11-01T00:00:00Z",
"consumption_period_end": "2022-12-01T00:00:00Z"
},
"roles": [
{
"branch_id": "br-wispy-meadow-118737",
"name": "casey",
"protected": false,
"created_at": "2022-11-23T17:42:25Z",
"updated_at": "2022-11-23T17:42:25Z"
}
],
"databases": [
{
"id": 834686,
"branch_id": "br-wispy-meadow-118737",
"name": "neondb",
"owner_name": "casey",
"created_at": "2022-11-30T18:25:15Z",
"updated_at": "2022-11-30T18:25:15Z"
}
],
"operations": [
{
"id": "d8ac46eb-a757-42b1-9907-f78322ee394e",
"project_id": "spring-example-302709",
"branch_id": "br-wispy-meadow-118737",
"endpoint_id": "ep-silent-smoke-806639",
"action": "start_compute",
"status": "finished",
"failures_count": 0,
"created_at": "2022-11-15T20:02:00Z",
"updated_at": "2022-11-15T20:02:02Z",
"total_duration_ms": 200
}
],
"branch": {
"id": "br-wispy-meadow-118737",
"project_id": "spring-example-302709",
"parent_id": "br-aged-salad-637688",
"parent_lsn": "0/1DE2850",
"name": "dev2",
"protected": false,
"current_state": "ready",
"state_changed_at": "2022-11-30T20:09:48Z",
"creation_source": "console",
"created_at": "2022-11-30T19:09:48Z",
"updated_at": "2022-12-01T19:53:05Z",
"default": true,
"init_source": "parent-data",
"data_transfer_bytes": 72911987,
"written_data_bytes": 542998300,
"compute_time_seconds": 823880990,
"active_time_seconds": 922200,
"cpu_used_sec": 461100
},
"endpoints": [
{
"host": "ep-silent-smoke-806639.us-east-2.aws.neon.tech",
"id": "ep-silent-smoke-806639",
"name": "My cool compute",
"project_id": "spring-example-302709",
"branch_id": "br-wispy-meadow-118737",
"autoscaling_limit_min_cu": 1,
"autoscaling_limit_max_cu": 1,
"region_id": "aws-us-east-2",
"type": "read_write",
"current_state": "init",
"pending_state": "active",
"settings": {
"pg_settings": {}
},
"pooler_enabled": false,
"pooler_mode": "transaction",
"disabled": false,
"passwordless_access": true,
"creation_source": "console",
"created_at": "2022-12-03T15:37:07Z",
"updated_at": "2022-12-03T15:37:07Z",
"proxy_host": "us-east-2.aws.neon.tech",
"suspend_timeout_seconds": 0,
"provisioner": "k8s-neonvm"
}
]
}