> ## Documentation Index > Fetch the complete documentation index at: https://docs.heffl.com/llms.txt > Use this file to discover all available pages before exploring further. # Create project > Creates a new project. Required: title, pipelineId (ppl_). Optional stageId (pps_) — if omitted, the first OPEN stage in the pipeline is used. Call GET /project-pipelines to discover IDs. projectLeadId defaults to the API key user. Custom field values use `cf_*` keys — see the [Custom fields](/api-v2/custom-fields) guide. ## OpenAPI ````yaml /openapi.v2.json post /projects openapi: 3.1.1 info: title: Heffl API v2 (Beta) version: 2.0.0 description: >- Heffl REST API v2 (beta) — resource-oriented endpoints with consistent response envelopes. Endpoints, schemas, and behavior may change until GA. See Agent workflows and ID prefixes guides for automation. contact: name: Heffl Support url: https://heffl.com/support email: support@heffl.com servers: - url: https://api.heffl.com/api/v2 description: Production API Server security: - ApiKeyAuth: [] paths: /projects: post: tags: - Objects summary: Create project description: >- Creates a new project. Required: title, pipelineId (ppl_). Optional stageId (pps_) — if omitted, the first OPEN stage in the pipeline is used. Call GET /project-pipelines to discover IDs. projectLeadId defaults to the API key user. Custom field values use `cf_*` keys — see the [Custom fields](/api-v2/custom-fields) guide. operationId: objects.projects.create requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ProjectInput' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Project' '400': description: Validation error or bad request content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '403': description: Insufficient permission content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/V2ApiError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/V2ApiError' components: schemas: ProjectInput: type: object properties: title: type: string description: Project title pipelineId: type: string description: Project pipeline ID (ppl_ prefix) stageId: anyOf: - type: string - type: 'null' description: >- Project pipeline stage ID (pps_ prefix). If omitted, the first OPEN stage in the pipeline is used. clientId: anyOf: - type: string - type: 'null' description: Contact or company ID (clt_ prefix) projectLeadId: anyOf: - type: string - type: 'null' description: >- Project lead user ID (usr_ prefix). Defaults to the API key user when omitted. salesPersonId: anyOf: - type: string - type: 'null' description: Sales person user ID (usr_ prefix) status: type: string enum: - ACTIVE - COMPLETED - CANCELLED description: Project status type: type: string enum: - flat_rate - retainer description: Project type startDate: type: string format: date-time description: Project start date endDate: type: string format: date-time description: Project end date budgetedHours: type: number description: Budgeted hours description: type: string description: Project description isInclusiveTax: type: boolean description: Whether project line item prices include tax assignees: type: array items: type: string description: Assignee user IDs (usr_ prefix) tags: type: array items: type: string description: Tag IDs (tag_ prefix) required: - title - pipelineId additionalProperties: description: >- Custom field values using cf_* keys. Only documented fields and cf_* keys are accepted. Project: type: object properties: id: anyOf: - type: string - type: 'null' description: Project ID (prj_ prefix) number: type: string description: Auto-generated project number title: type: string description: Project title status: anyOf: - type: string enum: - ACTIVE - COMPLETED - CANCELLED - type: 'null' description: Project status type: anyOf: - type: string enum: - flat_rate - retainer - type: 'null' description: Project type startDate: anyOf: - type: string format: date-time - type: 'null' description: Project start date endDate: anyOf: - type: string format: date-time - type: 'null' description: Project end date pipelineId: anyOf: - type: string - type: 'null' description: Project pipeline ID (ppl_ prefix) pipelineName: anyOf: - type: string - type: 'null' description: Pipeline name stageId: anyOf: - type: string - type: 'null' description: Project pipeline stage ID (pps_ prefix) stageName: anyOf: - type: string - type: 'null' description: Stage name projectLeadId: anyOf: - type: string - type: 'null' description: Project lead user ID (usr_ prefix) projectLeadName: anyOf: - type: string - type: 'null' description: Project lead name clientId: anyOf: - type: string - type: 'null' description: Client ID (clt_ prefix) clientName: anyOf: - type: string - type: 'null' description: Client name description: anyOf: - type: string - type: 'null' description: Project description budgetedHours: anyOf: - type: number - type: 'null' description: Budgeted hours createdAt: anyOf: - type: string format: date-time - type: 'null' description: When the project was created updatedAt: anyOf: - type: string format: date-time - type: 'null' description: When the project was last updated required: - id - number - title additionalProperties: description: >- Custom field values as top-level cf_* keys (for example cf_priority). There is no customFields wrapper. V2ApiError: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string message: type: string details: type: object securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key for authentication. Get yours at app.heffl.com/settings/developers ````