---
title: "Start an empty project"
method: POST
path: "/v2/projects/{id}/quick-start"
tags: ["Projects"]
---

# Start an empty project

`POST /v2/projects/{id}/quick-start`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/projects/{id}/quick-start`
- Auth: HTTP bearer

Write the first plan for a project from only its type and outreach approach: canon pipeline stages and email templates, no searches and no screening criteria. Starts the campaign so the sequence exists; searches and criteria are added inside the project afterwards. Returns 409 when the project already has a plan.

## Path parameters

- `id` string, required: Encrypted project identifier

## Request body

- QuickStartProjectRequest
  - `project_type` 'founder_fundraising' | 'vc_fundraising' | 'recruiting' | 'sales' | 'sales_direct' | 'job_search' | 'customer_interviews' | 'references' | 'referrals' | 'intro_request', required
  - `outreach_approach` 'warm_intro' | 'cold_warm_lever' | 'cold', required
  - `name` string: Project and sequence name. Defaults to "<Type>: <goal excerpt>".
  - `sender_company` string: The company you're reaching out for. Fills {sender_company} in the emails; your profile's company is the fallback.

## Response `200`

The project with its first plan

- object
  - `data` Project, required: A Village project
    - `id` string, required: Encrypted project identifier
    - `title` string, required
    - `goal` string, required
    - `project_type` string, nullable, required
    - `sequence_id` string, nullable, required
    - `pipeline_stages` PipelineStage[], required
      - `step` integer, required
      - `name` string, required
      - `description` string, required
      - `target` integer
      - `count` integer
    - `chatbot_messages` unknown
    - `ai_planner_output` unknown
    - `planner_searches_used` integer, required
    - `settings` unknown
    - `last_planner_run_at` string, date-time, nullable, required
    - `attachments` unknown
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication
- `404`: Project not found
- `409`: Project already has a plan

---

[API](https://skmtc.dev/village/apis/village-v2-api.md) - [All operations](https://skmtc.dev/village/apis/village-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/village/apis/village-v2-api/revisions/aebe21a1a544?raw)