> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new project

> 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.



## OpenAPI

````yaml api-reference/openapi-v3.json POST /api/v3/org/owner/project/new
openapi: 3.0.0
info:
  version: 3.0.0
  title: Composio Platform API
  description: >-
    Composio v3 API — legacy endpoints under /api/v3/. Use v3.1 for new
    integrations.
  contact:
    name: Composio Support
    url: https://composio.dev/support
    email: support@composio.dev
  license:
    name: Proprietary
    url: https://composio.dev/terms
servers:
  - url: https://backend.composio.dev
    description: Composio production API
security:
  - ApiKeyAuth: []
tags:
  - name: Authentication
    description: Authentication related endpoints
    x-group: Authentication
  - name: Auth Configs
    description: Authentication configuration management
    x-group: Auth Configs
  - name: Connected Accounts
    description: Connected account management
    x-group: Connected Accounts
  - name: Logs
    description: Logging and monitoring
    x-group: Logs
  - name: OpenAPI
    description: OpenAPI specification management
    x-group: OpenAPI
  - name: Organization
    description: Organization management
    x-group: Organization
  - name: API Keys
    description: API key management
    x-group: API Keys
  - name: Webhooks
    description: Webhook configuration
    x-group: Webhooks
  - name: Webhook Endpoints
    description: >-
      Per-OAuth-app webhook ingress endpoints. Inbound URLs the provider posts
      to, plus signing secret storage and verification.
    x-group: Webhook Endpoints
  - name: Webhook Subscriptions
    description: >-
      Webhook delivery subscriptions. Outbound URLs Composio posts trigger
      events to, plus signing secret rotation and event-type filters.
    x-group: Webhook Subscriptions
  - name: Team
    description: Team member management
    x-group: Team
  - name: Consumer Skills
    description: Organization-authored Skill management
    x-group: Consumer Skills
  - name: Toolkits
    description: Toolkit and tool management
    x-group: Toolkits
  - name: Tools
    description: Tool execution endpoints
    x-group: Tools
  - name: Triggers
    description: Trigger management and execution
    x-group: Triggers
  - name: Payments
    description: Payment and subscription management
    x-group: Payments
  - name: Billing
    description: Dashboard billing state — usage, subscription, contract (cookie-auth only)
    x-group: Billing
  - name: Compliance
    description: Organization compliance agreements and acceptance state
    x-group: Compliance
  - name: Files
    description: File management
    x-group: Files
  - name: MCP
    description: MCP server management
    x-group: MCP
  - name: MCP Partner
    description: MCP partner management
    x-group: MCP Partner
  - name: Stripe Projects
    description: Stripe Projects provisioning
    x-group: Stripe Projects
  - name: Tool Router
    description: (Labs) Tool router endpoints
    x-group: Sessions (Prev Tool Router)
  - name: Playground
    description: Dashboard playground chat
    x-group: Playground
  - name: Arena
    description: Arena conversations, messages and terms
    x-group: Arena
  - name: Organization Management
    description: Organization Management API endpoints.
    x-group: Organization Management
  - name: Projects
    description: Projects API endpoints.
    x-group: Projects
paths:
  /api/v3/org/owner/project/new:
    post:
      tags:
        - Projects
      summary: Create a new project
      description: >-
        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.
      operationId: postOrgOwnerProjectNew
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 3
                  maxLength: 75
                  pattern: ^[a-zA-Z0-9_-]+$
                  description: >-
                    A unique name for your project that follows the required
                    format rules
                  example: my-awesome-project
                should_create_api_key:
                  type: boolean
                  default: false
                  description: >-
                    Whether to create an API key for the project. If true, the
                    API key will be created and returned in the response.
                  example: false
                api_key_allowed_ips:
                  type: array
                  items:
                    type: string
                    format: ip
                  description: >-
                    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:
                    - 203.0.113.10
                api_key_permissions:
                  type: array
                  items:
                    type: object
                    properties:
                      preset:
                        type: string
                        enum:
                          - tools
                          - tool_execution
                          - proxy_execute
                          - session_management
                          - session_tool_execution
                          - legacy_mcp
                          - connected_accounts
                          - auth_configs
                          - toolkits
                          - triggers
                          - webhooks
                          - observability
                          - sessions
                      access:
                        type: string
                        enum:
                          - none
                          - read
                          - write
                          - read_write
                    required:
                      - preset
                      - access
                  description: >-
                    Permission levels for the project API key. Requires
                    should_create_api_key to be true. Omit to create a
                    full-access API key.
                  example:
                    - preset: tool_execution
                      access: write
                config:
                  type: object
                  properties:
                    is_2FA_enabled:
                      type: boolean
                    logo_url:
                      type: string
                    display_name:
                      type: string
                      maxLength: 75
                    mask_secret_keys_in_connected_account:
                      type: boolean
                    log_visibility_setting:
                      type: string
                      enum:
                        - show_all
                        - dont_store_data
                    is_composio_link_enabled_for_managed_auth:
                      type: boolean
                      description: >-
                        Whether to enable composio link for managed
                        authentication. This key will be deprecated in the
                        future. Please don't use this key.
                    signed_url_file_expiry_in_seconds:
                      type: number
                      minimum: 1
                      maximum: 86400
                    oauth_callback_verifier_url:
                      type: string
                      nullable: true
                      format: uri
                      description: >-
                        Developer-hosted OAuth callback verifier URL. Setting it
                        enables per-user callback identity verification; null
                        disables it. Must be https and pass SSRF checks.
                    theme:
                      type: object
                      additionalProperties: {}
                      description: >-
                        Link-auth theme for the hosted connect page. Opaque to
                        the API; the dashboard owns the token vocabulary and all
                        value validation.
                    enable_instant:
                      type: boolean
                      description: Enable Instant Toolkits for this project.
                    zdr_enabled:
                      type: boolean
                      description: >-
                        Enable Zero Data Retention for the new project. Hobby
                        cannot enable it. Enterprise defaults to enabled; other
                        paid plans default to disabled. An explicit value
                        overrides the default.
                  description: >-
                    Configuration for the project. Use zdr_enabled for Zero Data
                    Retention; log_visibility_setting remains supported for
                    existing clients. Do not send both fields.
              required:
                - name
            examples:
              Simple project:
                value:
                  name: my_production_api
      responses:
        '200':
          description: >-
            Project successfully created. Returns the complete project object
            with generated IDs, webhook secrets, and configuration.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: projectId
                    description: Unique identifier for the project
                    example: pr_1a2b3c4d5e6f
                  name:
                    type: string
                    description: Name of the project
                    example: My Awesome Project
                  api_key:
                    type: string
                    nullable: true
                    description: API key for the project
                    example: ak_a1b2c3d4e5f6g7h8i9j0
                required:
                  - id
                  - api_key
        '400':
          description: >-
            Bad request. This may occur if the project name format is invalid,
            too short, or contains invalid characters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: >-
            Unauthorized. Authentication is required or the provided credentials
            are invalid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Zero Data Retention requires a paid plan.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: >-
            Conflict. A project with this name already exists in the
            organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: >-
            Internal server error. An unexpected error occurred while processing
            the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - OrgApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: number
            slug:
              type: string
            status:
              type: number
            request_id:
              type: string
            suggested_fix:
              type: string
            errors:
              type: array
              items:
                type: string
          required:
            - message
            - code
            - slug
            - status
      required:
        - error
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Your Composio project API key. Create or copy it from the Composio
        dashboard.
      x-default: your-project-api-key
    OrgApiKeyAuth:
      type: apiKey
      in: header
      name: x-org-api-key
      description: Your Composio organization API key for organization-scoped endpoints.
      x-default: your-organization-api-key

````