Skip to main content
POST
https://api.taap.it
/
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.