API ReferenceProjects

Create a new project

Markdown
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

name*string

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

Match^[a-zA-Z0-9_-]+$
Length3 <= length <= 75
should_create_api_key?boolean

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

Defaultfalse
config?

Configuration for the project

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://backend.composio.dev/api/v3/org/owner/project/new" \  -H "Content-Type: application/json" \  -d '{    "name": "my_production_api"  }'
{
  "id": "proj_abc123xyz456",
  "name": "My Awesome Project",
  "api_key": "ak_abc123xyz456"
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}
{
  "error": {
    "message": "string",
    "code": 0,
    "slug": "string",
    "status": 0,
    "request_id": "string",
    "suggested_fix": "string",
    "errors": [
      "string"
    ]
  }
}