Scope: projects:projects.write https://api.alladdin.com/api/v2/projects

Creates a new project.
The response returns the new project id.

Request body

object name string required

Project name

description string | null optional

Project description

due_date string<date> | null optional

Due date in ISO 8601

contact_id string | null optional

Contact ID

Request

import requests

url = "https://api.alladdin.com/api/v2/projects"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "name": "string",
    "description": "string",
    "due_date": "2024-01-15",
    "contact_id": "string"
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Responses

Response

{
  "id": "507f1f77bcf86cd799439011"
}

Success responses

201 Project created application/json object id string

Error responses

400 Bad request application/json 401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Contact not found application/json 422 Validation error application/json 429 Rate limit exceeded application/json

Next →Update a project →