> ## Documentation Index
> Fetch the complete documentation index at: https://connectionshub.atlastube.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Project

> Create a new project to organize your calculations.



## OpenAPI

````yaml api/openapi.json POST /v1/projects
openapi: 3.1.0
info:
  title: Connections Hub API
  version: 1.0.0
  description: >-
    Run HSS Connections Hub calculators programmatically: create projects,
    create and solve sheets from any calculator template, run batches, and
    export reports to PDF.


    All endpoints require API key authentication.
servers:
  - url: https://api.calcs.com
security:
  - bearerAuth: []
tags:
  - name: Projects
    description: >-
      Create and manage calculation projects. Each user can have multiple
      projects to organize their calculations.
  - name: Sheets
    description: >-
      Manage individual calculation sheets — read one back, update its inputs,
      solve or re-solve it, and delete single sheets or clean up many at once.
  - name: Templates
    description: >-
      Run calculations using any enabled template. Supports all calculator types
      without requiring endpoint-specific code.
paths:
  /v1/projects:
    post:
      tags:
        - Projects
      summary: Create Project
      description: Create a new project to organize your calculations.
      operationId: create-project
      parameters:
        - name: Authorization
          in: header
          required: true
          example: Bearer YOUR_KEY_HERE
          schema:
            type: string
          description: >-
            The `Authorization` header is used to authenticate with the API
            using your API key. Value is of the format `Bearer YOUR_KEY_HERE`.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  description: Project name
                  example: Office Building Renovation
                projectNumber:
                  type: string
                  description: Optional project number
                  example: 2024-001
                clientName:
                  type: string
                  description: Optional client name
                  example: ABC Construction
                buildingStandard:
                  type: string
                  enum:
                    - US
                    - EU
                    - AU
                    - CA
                    - NZ
                  description: >-
                    Building standard/code region (US=United States,
                    EU=Europe/Eurocode, AU=Australia, CA=Canada, NZ=New Zealand)
                  default: US
                unitSystem:
                  type: string
                  enum:
                    - FPS
                    - MKS
                  description: Unit system (FPS=Imperial, MKS=Metric)
                  default: FPS
      responses:
        '201':
          description: Project created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  projectId:
                    type: string
                    format: uuid
                    description: Unique identifier for the created project
                  projectUrl:
                    type: string
                    format: uri
                    description: >-
                      Direct link to the project in the Calcs.com app. Always
                      present on a successful response.
                  name:
                    type: string
                    description: Project name
                required:
                  - projectId
                  - name
              example:
                projectId: 662f0b28-3c2e-4dae-a61b-1bdfa367373b
                projectUrl: >-
                  https://app.calcs.com/project/662f0b28-3c2e-4dae-a61b-1bdfa367373b
                name: API Test Project
        '400':
          description: Invalid request - missing required fields or invalid values
        '401':
          description: Unauthorized - invalid or missing API key
      security:
        - api_key: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send your API key as a bearer token: `Authorization: Bearer
        YOUR_API_KEY`. Every endpoint requires one.
    api_key:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.