---
title: "Create Calendar Event/Task Status"
method: POST
path: "/admin/calendar_entry_statuses"
tags: ["Calendar Event/Task Statuses"]
---

# Create Calendar Event/Task Status

`POST /admin/calendar_entry_statuses`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/calendar_entry_statuses`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Create a new calendar entry status for the current account.

New custom statuses are automatically inserted before the "Done" system status.
The `status_type` field defaults to `custom` and cannot be set to `todo` or `done`
(system statuses are automatically created per account).

## Request body

- object
  - `calendar_entry_status` CalendarEntryStatusWritable
    - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
    - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
    - `name` string: The name/label of the calendar entry status. Must be unique within the account.
    - `position` integer: Order position in list of statuses. Automatically managed for system statuses (To-Do and Done).
    - `hex_color` string: The color to display the status (hex code with '#' prefix)
    - `status_type` 'custom' | 'todo' | 'done': The type of status: - `custom`: User-created status (default). Can be reordered, edited, and deleted. - `todo`: System "To-Do" status. Always appears first. Cannot be reordered or deleted. - `done`: System "Done" status. Always appears last. Cannot be reordered or deleted. System statuses (todo/done) are automatically created and maintained per account.

## Response `200`

Successful Response

- CalendarEntryStatusAll
  - `id` integer: Unique identifier
  - `in_use` boolean: Whether any calendar entry currently uses this status
  - `created_at` string: Timestamp when the record was created (time zone in user's time zone).
  - `updated_at` string: Timestamp when the record was last touched (time zone in user's time zone).
  - `name` string: The name/label of the calendar entry status. Must be unique within the account.
  - `position` integer: Order position in list of statuses. Automatically managed for system statuses (To-Do and Done).
  - `hex_color` string: The color to display the status (hex code with '#' prefix)
  - `status_type` 'custom' | 'todo' | 'done': The type of status: - `custom`: User-created status (default). Can be reordered, edited, and deleted. - `todo`: System "To-Do" status. Always appears first. Cannot be reordered or deleted. - `done`: System "Done" status. Always appears last. Cannot be reordered or deleted. System statuses (todo/done) are automatically created and maintained per account.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - Admin access required
- `422`: Validation Error

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)