Skip to main content
POST
/
v1
/
projects
Create Project
curl --request POST \
  --url https://api.taap.it/v1/projects \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "color": "<string>"
}
'
{
  "id": "<string>",
  "created_at": "<string>",
  "name": "<string>",
  "description": "<string>",
  "color": "<string>"
}
Request:
cURL
curl -X POST 'https://api.taap.it/v1/projects' \
  -H 'Authorization: Bearer taapit_your_api_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Summer Marketing Campaign",
    "description": "Links for our summer marketing campaign",
    "color": "#FF6B6B"
  }'
Response: 
{
  "id": "project_987654321",
  "created_at": "2024-01-15T10:30:00Z",
  "name": "Summer Marketing Campaign",
  "description": "Links for our summer marketing campaign",
  "color": "#FF6B6B"
}

​
Authorization

​
Authorization
string
required
Bearer token for API authentication. Format: Bearer YOUR_API_KEY

​
Request Parameters

​
name
string
required
Name of the project
​
description
string
Optional description for the project
​
color
string
default:"#000000"
Color for the project in hex format (e.g., #FF6B6B, #FFF). Defaults to #000000 (black) if not provided. Must include the # symbol and be a valid 3 or 6 character hex color.

​
Response Fields

​
id
string
required
Unique identifier for the created project
​
created_at
string
required
ISO 8601 timestamp when the project was created
​
name
string
required
Name of the project
​
description
string
Description of the project
​
color
string
required
Color of the project in hex format (uppercase). Always present with default value #000000 if not specified during creation.