COcomposiohq
Projects
Organization

Create a new project

Changed on

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.

post/api/v3/org/owner/project/new

Request

  • Base URL
    https://backend.composio.dev
  • URL
    https://backend.composio.dev/api/v3/org/owner/project/new
  • Auth
    API key in header x-org-api-key

Request body

namestring required

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.

api_key_allowed_ipsstring[]

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.

Example request

{
  "name": "my-awesome-project",
  "api_key_allowed_ips": [
    "203.0.113.10"
  ],
  "api_key_permissions": [
    {
      "preset": "tool_execution",
      "access": "write"
    }
  ]
}

Response

Project successfully created. Returns the complete project object with generated IDs, webhook secrets, and configuration.

idstring projectId required

Unique identifier for the project

namestring

Name of the project

api_keystring nullable required

API key for the project

Example response

{
  "id": "pr_1a2b3c4d5e6f",
  "name": "My Awesome Project",
  "api_key": "ak_a1b2c3d4e5f6g7h8i9j0"
}

Changes