Create a task status Run in API Explorer

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://apidocs.plannrcrm.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "PlannrCRM MCP server": {
    "url": "https://apidocs.plannrcrm.com/mcp"
  }
}
Close
POST /api/v1/task-status
Personal access token & O auth2

Headers

  • X-PLANNR-ACCOUNT-UUID string
application/json

Body

  • name string Required

    Name of the task status

  • colour string

    Colour of the task status

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • uuid string
    • created_at string
    • updated_at string
    • name string
    • colour string
    • position integer
    • is_type_completed boolean
    • is_archived boolean
    • is_not_started boolean
  • 422 application/json

    Validation error

    Hide response attributes Show response attributes object
    • message string Required

      A human-readable description of the error.

    • errors object

      Validation messages keyed by the field that failed.

      Hide errors attribute Show errors attribute object
      • * array[string] Additional properties
POST /api/v1/task-status 
curl \
 --request POST 'https://api.plannrcrm.com/api/v1/task-status' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{
  "name": "Incomplete",
  "colour": "#ff0000"
}'
Request examples 
# Headers
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Incomplete",
  "colour": "#ff0000"
}
Response examples (201) 
[
  {
    "uuid": "5e50c357-a6bf-48a8-b608-cc7e2120bfdb",
    "created_at": "2026-10-08T16:24:03+01:00",
    "updated_at": "2026-10-08T16:24:03+01:00",
    "name": "Incomplete",
    "colour": "#398898",
    "position": 1,
    "is_type_completed": false,
    "is_archived": false,
    "is_not_started": false
  }
]
Response examples (422) 
{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is invalid."
    ]
  }
}