---
title: "Create project"
method: POST
path: "/projects"
tags: ["Project Management"]
---

# Create project

`POST /projects`

## Request

- Base URL: `https://blitzreels.com/api/v1`
- URL: `https://blitzreels.com/api/v1/projects`
- Auth: API key in header `Authorization`

Create project.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `series_id` string, uuid, nullable
  - `name` string, required
  - `description` string
  - `aspect_ratio` '9:16' | '16:9' | '1:1' | '4:5'
  - `project_type` 'video' | 'carousel'
  - `carousel_settings` object
    - `platform` 'tiktok' | 'instagram'
    - `safe_area_preset` 'tiktok_9_16' | 'instagram_4_5' | 'instagram_1_1'
    - `slide_count` integer
    - `background_strategy` 'solid' | 'gradient' | 'image' | 'mixed'
    - `export_formats` string[]
    - `jpeg_quality` integer

## Response `200`

Successful response

- object
  - `series_id` string, uuid, nullable, required
  - `id` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `aspect_ratio` '9:16' | '16:9' | '1:1' | '4:5', nullable, required
  - `status` string, required
  - `thumbnail_url` string, nullable
  - `created_at` string, required
  - `updated_at` string, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `500`: Internal server error

---

[API](https://skmtc.dev/blitzreels/apis/blitzreels-api.md) · [All operations](https://skmtc.dev/blitzreels/apis/blitzreels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blitzreels/apis/blitzreels-api/revisions/35608b12471d?raw)