[metadata]
article:modified_time: 2026-05-27T10:11:51.000Z
dateModified: 2026-05-27T10:11:51.000Z
description: 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](https://neon.com/docs/manage/projects/). You can specify a region and Postgres version in the request body. Neon supports Postgres 14 through 18, with 19 rolling out to enabled regions. For supported regions and `region_id` values, see [Regions](https://neon.com/docs/introduction/regions/).
loadedProject: neon-tech
og:description: 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](https://neon.com/docs/manage/projects/). You can specify a region and Postgres version in the request body. Neon supports Postgres 14 through 18, with 19 rolling out to enabled regions. For supported regions and `region_id` values, see [Regions](https://neon.com/docs/introduction/regions/).
og:image: https://cdn.readme.io/og-image/create?type=reference&title=Create%20project&projectTitle=Neon&description=Creates%20a%20Neon%20project%20within%20an%20organization.%0AIf%20using%20a%20personal%20API%20key%2C%20include%20the%20%60org_id%60%20parameter%20to%20specify%20which%20organization%20to%20create%20the%20project%20in.%0AIf%20using%20an%20org%20API%20key%2C%20%60org_id%60%20is%20automatically%20inferred%20from%20the%20key.%0APlan%20limits%20define%20how%20many%20projects%20you%20can%20create.%0AFor%20more%20information%2C%20see%20%5BManage%20projects%5D(https%3A%2F%2Fneon.com%2Fdocs%2Fmanage%2Fprojects%2F).%0A%0AYou%20can%20specify%20a%20region%20and%20Postgres%20version%20in%20the%20request%20body.%0ANeon%20supports%20Postgres%2014%20through%2018%2C%20with%2019%20rolling%20out%20to%20enabled%20regions.%0AFor%20supported%20regions%20and%20%60region_id%60%20values%2C%20see%20%5BRegions%5D(https%3A%2F%2Fneon.com%2Fdocs%2Fintroduction%2Fregions%2F).%0A&logoUrl=https%3A%2F%2Ffiles.readme.io%2F0ca1059c21bc57f37633ffc5d824ad2b0014b93e07946db19f675713edaf117f-neon-logo-light-color.svg&color=%23e5e5e5&variant=light
og:image:height: 630
og:image:width: 1200
og:site_name: Neon
og:title: Create project
og:updated_time: 2026-05-27T10:11:51.000Z
readme-deploy: 5.838.2
readme-project-flags: GaXfa76izKu2Xs93v/Bypg==:CccvDFeDQIlAMuBrw4XAtQ/RontEln7WiRnvliIqgCySOpUpUBnxBHgRKehS8evRZofuQyeOq/SIpxV1u3w5qxBJvPsxkU4OQx29R+SEJH9bfbA6CYqQM3uyPcDD2mzqGZcFo82FwXsDoz7tBGi6pA==
readme-repo: neon-tech-5117089289c2
readme-subdomain: neon-tech
readme-version: 2.0
twitter:card: summary_large_image
twitter:description: 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](https://neon.com/docs/manage/projects/). You can specify a region and Postgres version in the request body. Neon supports Postgres 14 through 18, with 19 rolling out to enabled regions. For supported regions and `region_id` values, see [Regions](https://neon.com/docs/introduction/regions/).
twitter:image: https://cdn.readme.io/og-image/create?type=reference&title=Create%20project&projectTitle=Neon&description=Creates%20a%20Neon%20project%20within%20an%20organization.%0AIf%20using%20a%20personal%20API%20key%2C%20include%20the%20%60org_id%60%20parameter%20to%20specify%20which%20organization%20to%20create%20the%20project%20in.%0AIf%20using%20an%20org%20API%20key%2C%20%60org_id%60%20is%20automatically%20inferred%20from%20the%20key.%0APlan%20limits%20define%20how%20many%20projects%20you%20can%20create.%0AFor%20more%20information%2C%20see%20%5BManage%20projects%5D(https%3A%2F%2Fneon.com%2Fdocs%2Fmanage%2Fprojects%2F).%0A%0AYou%20can%20specify%20a%20region%20and%20Postgres%20version%20in%20the%20request%20body.%0ANeon%20supports%20Postgres%2014%20through%2018%2C%20with%2019%20rolling%20out%20to%20enabled%20regions.%0AFor%20supported%20regions%20and%20%60region_id%60%20values%2C%20see%20%5BRegions%5D(https%3A%2F%2Fneon.com%2Fdocs%2Fintroduction%2Fregions%2F).%0A&logoUrl=https%3A%2F%2Ffiles.readme.io%2F0ca1059c21bc57f37633ffc5d824ad2b0014b93e07946db19f675713edaf117f-neon-logo-light-color.svg&color=%23e5e5e5&variant=light
twitter:title: Create project
viewport: width=device-width, initial-scale=1.0

[canonical-links]
https://api-docs.neon.tech/reference/createproject

[document-links]
AI Gateway: /reference/getprojectbranchaigateway
API Key: /reference/listapikeys
API Reference: /reference
API rate limiting: /reference/api-rate-limiting
Accept a project transfer request: /reference/acceptprojecttransferrequest
Add JWKS URL: /reference/addprojectjwks
Add an OAuth provider: /reference/addbranchneonauthoauthprovider
Add an OAuth provider: /reference/addneonauthoauthprovider
Add domain to redirect_uri whitelist: /reference/addbranchneonauthtrusteddomain
Add trusted redirect URI domain: /reference/addneonauthdomaintoredirecturiwhitelist
Assign or update VPC endpoint: /reference/assignorganizationvpcendpoint
Auth (legacy): /reference/createneonauthintegration
Auth: /reference/getneonauth
Authentication: /reference/authentication
Branch: /reference/createprojectbranch
Buckets: /reference/createprojectbranchbucket
Compare database schema: /reference/getprojectbranchschemacomparison
Consumption: /reference/getconsumptionhistoryperproject
Create API key: /reference/createapikey
Create Auth Provider SDK keys: /reference/createneonauthprovidersdkkeys
Create Neon Auth integration: /reference/createneonauthintegration
Create Neon Data API: /reference/createprojectbranchdataapi
Create a bucket on the branch: /reference/createprojectbranchbucket
Create a project transfer request: /reference/createprojecttransferrequest
Create anonymized branch: /reference/createprojectbranchanonymized
Create branch: /reference/createprojectbranch
Create compute endpoint: /reference/createprojectendpoint
Create database: /reference/createprojectbranchdatabase
Create new auth user: /reference/createbranchneonauthnewuser
Create new auth user: /reference/createneonauthnewuser
Create organization API key: /reference/createorgapikey
Create organization invitations: /reference/createorganizationinvitations
Create project: /reference/createproject
Create role: /reference/createprojectbranchrole
Create snapshot: /reference/createsnapshot
Credentials: /reference/createcredential
DataAPI: /reference/createprojectbranchdataapi
Delete JWKS URL: /reference/deleteprojectjwks
Delete Neon Data API: /reference/deleteprojectbranchdataapi
Delete OAuth provider: /reference/deletebranchneonauthoauthprovider
Delete OAuth provider: /reference/deleteneonauthoauthprovider
Delete VPC endpoint restriction: /reference/deleteprojectvpcendpoint
Delete VPC endpoint: /reference/deleteorganizationvpcendpoint
Delete a bucket on the branch: /reference/deleteprojectbranchbucket
Delete a function on the branch: /reference/deleteprojectbranchfunction
Delete an object in a bucket: /reference/deleteprojectbranchbucketobject
Delete auth user: /reference/deletebranchneonauthuser
Delete auth user: /reference/deleteneonauthuser
Delete branch: /reference/deleteprojectbranch
Delete compute endpoint: /reference/deleteprojectendpoint
Delete database: /reference/deleteprojectbranchdatabase
Delete domain from redirect_uri whitelist: /reference/deletebranchneonauthtrusteddomain
Delete every object under a key prefix (folder) in a bucket: /reference/deleteprojectbranchbucketobjectsbyprefix
Delete integration with auth provider: /reference/deleteneonauthintegration
Delete project: /reference/deleteproject
Delete role: /reference/deleteprojectbranchrole
Delete snapshot: /reference/deletesnapshot
Delete trusted redirect URI domain: /reference/deleteneonauthdomainfromredirecturiwhitelist
Deploy code to a function: /reference/createprojectbranchfunctiondeployment
Disable Neon Auth for the branch: /reference/disableneonauth
Discord: https://discord.com/invite/92vNTzKDGp
Download an object's bytes: /reference/getprojectbranchbucketobject
Enable Neon Auth for the branch: /reference/createneonauth
Endpoint: /reference/createprojectendpoint
Finalize branch restore from snapshot: /reference/finalizerestorebranch
Functions: /reference/listprojectbranchfunctions
Get advisor issues: /reference/getprojectadvisorsecurityissues
Get branch AI Gateway endpoint: /reference/getprojectbranchaigateway
Get branch object storage state: /reference/getprojectbranchstorage
Get function details: /reference/getprojectbranchfunction
Grant project access: /reference/grantpermissiontoproject
Issue a scoped credential on the branch: /reference/createcredential
List API keys: /reference/listapikeys
List JWKS URLs: /reference/getprojectjwks
List OAuth providers for the branch: /reference/listbranchneonauthoauthproviders
List OAuth providers: /reference/listneonauthoauthproviders
List VPC endpoint restrictions: /reference/listprojectvpcendpoints
List VPC endpoints across all regions: /reference/listorganizationvpcendpointsallregions
List VPC endpoints: /reference/listorganizationvpcendpoints
List active integrations with auth providers: /reference/listneonauthintegrations
List available shared preload libraries: /reference/getavailablepreloadlibraries
List branch endpoints: /reference/listprojectbranchendpoints
List branch log field values: /reference/listprojectbranchlogfieldvalues
List branch log fields: /reference/listprojectbranchlogfields
List branches: /reference/listprojectbranches
List buckets on the branch: /reference/listprojectbranchbuckets
List compute endpoints: /reference/listprojectendpoints
List credentials on the branch: /reference/listcredentials
List databases: /reference/listprojectbranchdatabases
List domains in redirect_uri whitelist: /reference/listbranchneonauthtrusteddomains
List functions on the branch: /reference/listprojectbranchfunctions
List objects in a bucket: /reference/listprojectbranchbucketobjects
List operations: /reference/listprojectoperations
List org members and their project roles: /reference/listprojectmembers
List organization API keys: /reference/listorgapikeys
List organization invitations: /reference/getorganizationinvitations
List organization members: /reference/getorganizationmembers
List organizations for the current user: /reference/getcurrentuserorganizations
List project access: /reference/listprojectpermissions
List project snapshots: /reference/listsnapshots
List projects: /reference/listprojects
List roles: /reference/listprojectbranchroles
List shared projects: /reference/listsharedprojects
List supported regions: /reference/getactiveregions
List trusted redirect URI domains: /reference/listneonauthredirecturiwhitelistdomains
Logs: /reference/queryprojectbranchlogs
Manage projects: https://neon.com/docs/manage/projects/
Neon API Reference: /reference/getting-started-with-neon-api
Neon API for AI Agents: /reference/ai-agents
Neon Console: https://console.neon.tech/
Neon Docs: https://neon.com/docs/introduction/about
Neon OpenAPI Specification: https://neon.com/api_spec/release/v2.json
Operation: /reference/getprojectoperation
Organizations: /reference/getorganization
Pagination: /reference/pagination
Path parameters: /reference/path-parameters
Presign an upload or download for an object in a bucket: /reference/presignprojectbranchbucketobject
Project: /reference/listprojects
Query branch logs: /reference/queryprojectbranchlogs
Recover a deleted project: /reference/recoverproject
Region: /reference/getactiveregions
Regions: https://neon.com/docs/introduction/regions/
Remove an org member's role on a project: /reference/removeprojectmemberrole
Remove organization member: /reference/removeorganizationmember
Remove organization spending limit: /reference/deleteorganizationspendinglimit
Reset role password: /reference/resetprojectbranchrolepassword
Restart compute endpoint: /reference/restartprojectendpoint
Restore branch to a historical state: /reference/restoreprojectbranch
Restore snapshot: /reference/restoresnapshot
Retrieve Neon Auth details for the branch: /reference/getneonauth
Retrieve Neon Auth plugin configurations: /reference/getneonauthpluginconfigs
Retrieve Neon Auth webhook configuration: /reference/getneonauthwebhookconfig
Retrieve Neon Data API configuration: /reference/getprojectbranchdataapi
Retrieve VPC endpoint details: /reference/getorganizationvpcendpointdetails
Retrieve anonymized branch status: /reference/getanonymizedbranchstatus
Retrieve backup schedule: /reference/getsnapshotschedule
Retrieve branch consumption metrics: /reference/getconsumptionhistoryperbranchv2
Retrieve branch details: /reference/getprojectbranch
Retrieve compute endpoint details: /reference/getprojectendpoint
Retrieve connection URI: /reference/getconnectionuri
Retrieve current user details: /reference/getcurrentuserinfo
Retrieve database details: /reference/getprojectbranchdatabase
Retrieve database schema: /reference/getprojectbranchschema
Retrieve email and password configuration: /reference/getneonauthemailandpasswordconfig
Retrieve email provider configuration: /reference/getneonauthemailprovider
Retrieve email server configuration: /reference/getneonauthemailserver
Retrieve localhost allow setting: /reference/getneonauthallowlocalhost
Retrieve masking rules: /reference/getmaskingrules
Retrieve number of branches: /reference/countprojectbranches
Retrieve operation details: /reference/getprojectoperation
Retrieve organization details: /reference/getorganization
Retrieve organization member details: /reference/getorganizationmember
Retrieve organization spending limit: /reference/getorganizationspendinglimit
Retrieve phone number plugin configuration: /reference/getneonauthphonenumberplugin
Retrieve project consumption metrics (legacy plans): /reference/getconsumptionhistoryperproject
Retrieve project consumption metrics: /reference/getconsumptionhistoryperprojectv2
Retrieve project details: /reference/getproject
Retrieve request authentication details: /reference/getauthdetails
Retrieve role details: /reference/getprojectbranchrole
Retrieve role password: /reference/getprojectbranchrolepassword
Revoke API key: /reference/revokeapikey
Revoke a credential: /reference/revokecredential
Revoke organization API key: /reference/revokeorgapikey
Revoke project access: /reference/revokepermissionfromproject
SDKs and providers for the Neon API: /reference/sdks-for-the-neon-api
Send test email: /reference/sendneonauthtestemail
Set VPC endpoint restriction: /reference/assignprojectvpcendpoint
Set an org member's role on a project: /reference/setprojectmemberrole
Set branch as default: /reference/setdefaultprojectbranch
Set organization spending limit: /reference/setorganizationspendinglimit
Snapshot: /reference/createsnapshot
Start anonymization: /reference/startanonymization
Start compute endpoint: /reference/startprojectendpoint
Storage: /reference/getprojectbranchstorage
Suspend compute endpoint: /reference/suspendprojectendpoint
Transfer Neon-managed auth project to your own account: /reference/transferneonauthproviderproject
Transfer projects between organizations: /reference/transferprojectsfromorgtoorg
Transfer projects from personal account to organization: /reference/transferprojectsfromusertoorg
Update Neon Auth webhook configuration: /reference/updateneonauthwebhookconfig
Update Neon Data API: /reference/updateprojectbranchdataapi
Update OAuth provider: /reference/updatebranchneonauthoauthprovider
Update OAuth provider: /reference/updateneonauthoauthprovider
Update a function: /reference/updateprojectbranchfunction
Update auth user role: /reference/updateneonauthuserrole
Update backup schedule: /reference/setsnapshotschedule
Update branch: /reference/updateprojectbranch
Update compute endpoint: /reference/updateprojectendpoint
Update database: /reference/updateprojectbranchdatabase
Update email and password configuration: /reference/updateneonauthemailandpasswordconfig
Update email provider configuration: /reference/updateneonauthemailprovider
Update email server configuration: /reference/updateneonauthemailserver
Update localhost allow setting: /reference/updateneonauthallowlocalhost
Update magic link plugin configuration: /reference/updateneonauthmagiclinkplugin
Update masking rules: /reference/updatemaskingrules
Update organization plugin configuration: /reference/updateneonauthorganizationplugin
Update phone number plugin configuration: /reference/updateneonauthphonenumberplugin
Update project: /reference/updateproject
Update role for organization member: /reference/updateorganizationmember
Update snapshot: /reference/updatesnapshot
Use cases: /reference/use-cases
Users: /reference/getcurrentuserinfo
https://neon.com/

[structured-data]
{"@context":"https://schema.org","@type":"TechArticle","dateModified":"2026-05-27T10:11:51.000Z","headline":"Create project"}

[content]
Create project
For AI agents: visit https://api-docs.neon.tech/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
Jump to Content
Neon OpenAPI Specification
Neon Docs
Neon Console
Discord
API Reference
v2.0
Neon OpenAPI Specification
Neon Docs
Neon Console
Discord
API Reference
v2.0
API Reference
Create project
JUMP TO
Neon API
Neon API Reference
API Key
List API keys
Create API key
Revoke API key
Operation
Retrieve operation details
List operations
Project
List projects
Create project
List shared projects
Retrieve project details
Update project
Delete project
List project access
Grant project access
Revoke project access
List available shared preload libraries
Create a project transfer request
Accept a project transfer request
List JWKS URLs
Add JWKS URL
Delete JWKS URL
Retrieve connection URI
List VPC endpoint restrictions
Set VPC endpoint restriction
Delete VPC endpoint restriction
Recover a deleted project
Get advisor issues
List org members and their project roles
Set an org member's role on a project
Remove an org member's role on a project
Branch
Create branch
List branches
Retrieve number of branches
Retrieve branch details
Delete branch
Update branch
Restore branch to a historical state
Retrieve database schema
Compare database schema
Set branch as default
List branch endpoints
Finalize branch restore from snapshot
List databases
Create database
Retrieve database details
Update database
Delete database
List roles
Create role
Retrieve role details
Delete role
Retrieve role password
Reset role password
Create anonymized branch
Retrieve masking rules
Update masking rules
Retrieve anonymized branch status
Start anonymization
Endpoint
Create compute endpoint
List compute endpoints
Retrieve compute endpoint details
Delete compute endpoint
Update compute endpoint
Start compute endpoint
Suspend compute endpoint
Restart compute endpoint
Snapshot
Create snapshot
List project snapshots
Delete snapshot
Update snapshot
Restore snapshot
Retrieve backup schedule
Update backup schedule
Region
List supported regions
Users
Retrieve current user details
List organizations for the current user
Transfer projects from personal account to organization
Retrieve request authentication details
Consumption
Retrieve project consumption metrics (legacy plans)
Retrieve project consumption metrics
Retrieve branch consumption metrics
Organizations
Retrieve organization details
List organization API keys
Create organization API key
Revoke organization API key
List organization members
Retrieve organization member details
Update role for organization member
Remove organization member
List organization invitations
Create organization invitations
Transfer projects between organizations
List VPC endpoints
List VPC endpoints across all regions
Retrieve VPC endpoint details
Assign or update VPC endpoint
Delete VPC endpoint
Retrieve organization spending limit
Set organization spending limit
Remove organization spending limit
Use cases
Auth
Retrieve Neon Auth details for the branch
Enable Neon Auth for the branch
Disable Neon Auth for the branch
List domains in redirect_uri whitelist
Add domain to redirect_uri whitelist
Delete domain from redirect_uri whitelist
Create new auth user
Delete auth user
Update auth user role
List OAuth providers for the branch
Add an OAuth provider
Update OAuth provider
Delete OAuth provider
Send test email
Retrieve email and password configuration
Update email and password configuration
Retrieve email provider configuration
Update email provider configuration
Retrieve localhost allow setting
Update localhost allow setting
Retrieve Neon Auth plugin configurations
Update organization plugin configuration
Retrieve Neon Auth webhook configuration
Update Neon Auth webhook configuration
Update magic link plugin configuration
Retrieve phone number plugin configuration
Update phone number plugin configuration
Authentication
Pagination
Path parameters
SDKs and providers for the Neon API
Neon API for AI Agents
API rate limiting
Auth (legacy)
Create Neon Auth integration
List trusted redirect URI domains
Add trusted redirect URI domain
Delete trusted redirect URI domain
Create Auth Provider SDK keys
Create new auth user
Delete auth user
Transfer Neon-managed auth project to your own account
List active integrations with auth providers
List OAuth providers
Add an OAuth provider
Update OAuth provider
Delete OAuth provider
Retrieve email server configuration
Update email server configuration
Delete integration with auth provider
Storage
Get branch object storage state
Buckets
Create a bucket on the branch
List buckets on the branch
Delete a bucket on the branch
List objects in a bucket
Delete an object in a bucket
Download an object's bytes
Delete every object under a key prefix (folder) in a bucket
Presign an upload or download for an object in a bucket
Functions
List functions on the branch
Get function details
Update a function
Delete a function on the branch
Deploy code to a function
AI Gateway
Get branch AI Gateway endpoint
Logs
Query branch logs
List branch log fields
List branch log field values
Credentials
Issue a scoped credential on the branch
List credentials on the branch
Revoke a credential
DataAPI
Create Neon Data API
Delete Neon Data API
Retrieve Neon Data API configuration
Update Neon Data API
Create project
Copy Page
post
https://console.neon.tech/api/v2
/projects
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 supports Postgres 14 through 18, with 19 rolling out to enabled regions.
For supported regions and
region_id
values, see
Regions
.
Body Params
project
object
required
Configuration for the new project, including name, region, and Postgres compute and storage settings.
project
object
Responses
201
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.
default
General Error.
The request may or may not be safe to retry, depending on the HTTP method, response status code,
and whether a response was received.
If no response is returned from the API, a network error or timeout likely occurred.
In some cases, the request may have reached the server and been successfully processed, but the response failed to reach the client. As a result, retrying non-idempotent requests can lead to unintended results.
The following HTTP methods are considered non-idempotent:
POST
,
PATCH
,
DELETE
, and
PUT
. Retrying these methods is generally
not safe
.
The following methods are considered idempotent:
GET
,
HEAD
, and
OPTIONS
. Retrying these methods is
safe
in the event of a network error or timeout.
Any request that returns a
503 Service Unavailable
response is always safe to retry.
Any request that returns a
423 Locked
response is safe to retry.
423 Locked
indicates that the resource is temporarily locked, for example, due to another operation in progress.
Updated
2 months ago
List projects
List shared projects
Did this page help you?
Yes
No
Language
Shell
Credentials
Bearer
Loading…
Response
Click
Try It!
to start a request and see the response here!
Or choose an example:
application/json
201
default
Updated
2 months ago
List projects
List shared projects
Did this page help you?
Yes
No
