API ReferenceProjects

Create a new projectv3.0

POST
/api/v3/org/owner/project/new

Creates a new project within the authenticated user's organization using the specified name. Projects are isolated environments within your organization, each with their own API keys, webhook configurations, and resources. Use this endpoint to create additional projects for different environments (e.g., development, staging, production) or for separate applications.

Authorization

OrgApiKeyAuth
x-org-api-key<token>

Organization API key authentication

In: header

Request Body

application/json

namestringRequired

A unique name for your project that follows the required format rules

should_create_api_keyboolean

Whether to create an API key for the project. If true, the API key will be created and returned in the response.

Default: false
api_key_allowed_ipsarray of string

IPv4 or IPv6 addresses allowed to use the project API key. Requires should_create_api_key to be true. Omit to allow requests from any IP address.

api_key_permissionsarray of object

Permission levels for the project API key. Requires should_create_api_key to be true. Omit to create a full-access API key.

configobject

Configuration for the project. Use zdr_enabled for Zero Data Retention; log_visibility_setting remains supported for existing clients. Do not send both fields.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v3/org/owner/project/new" \  -H "Content-Type: application/json" \  -d '{    "name": "my_production_api"  }'
{  "id": "pr_1a2b3c4d5e6f",  "name": "My Awesome Project",  "api_key": "ak_a1b2c3d4e5f6g7h8i9j0"}
Edit this page on GitHub