POST /v1/projects
Creates a new project under your account.
code
POST https://api.flushkit.dev/v1/projects
Authentication
Include your API key as a Bearer token:
code
Authorization: Bearer fk_live_••••••••••••••••
Request body
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | required | Display name for the project. Must be between 1 and 64 characters. |
Example request
bash
curl -X POST https://api.flushkit.dev/v1/projects \
-H "Authorization: Bearer fk_live_••••••••••••••••" \
-H "Content-Type: application/json" \
-d '{ "name": "My App" }'
Response
201 Created
json
{
"id": "proj_01hxyz",
"name": "My App",
"createdAt": "2025-06-01T12:00:00.000Z"
}
403 Forbidden — project limit reached
json
{
"code": "PROJECT_LIMIT_REACHED",
"limit": 1,
"current": 1
}
Returned when your plan's project limit has been reached. Upgrade to create additional projects.
401 Unauthorized
json
{ "code": "UNAUTHORIZED", "message": "Invalid or missing API key." }
422 Unprocessable Entity
json
{ "code": "VALIDATION_ERROR", "message": "name is required." }
The Free plan allows one project. Starter and Growth plans allow unlimited projects.