# Create a task

**POST /api/v1/task**




## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)




### Body: application/json (object)

- **name** (string)
  The name of the task
- **description** (string)
  The description of the task
- **priority** (string)
  The task's priority. Available options: low, medium, high and highest
- **due_at** (string)
  The task due date
- **taskable_type** (string)
  The taskable type. Available Options: client, case, plan
- **taskable_uuid** (string)
  The taskable UUID
- **task_status_uuid** (string)
  The task status UUID
- **parent_task_uuid** (string)
  The parent task UUID
- **assigned_to_uuids** (array[string])
  Array of account UUIDs
- **custom_fields** (array[string])
  Additional custom fields
- **group_uuids** (array[string])
  UUIDs of groups that will be assigned when the task is created.


## Responses
### 201


#### Body: application/json (object)
- **uuid** (string)
  The UUID of the resource.
- **created_at** (string)
  The timestamp of when the resource was created.
- **updated_at** (string)
  The timestamp of when the resource was updated.
- **name** (string)
  The name of the task
- **description** (string)
  The description of the task
- **priority** (string)
  The priority of the task. Available Options: low, medium, high and highest
- **position** (integer)
  The position of the task
- **due_at** (string)
  The due date of the task
- **status** (object)
  The status of the task. Can be any of the task statuses defined in the firm's settings
- **taskable_type** (string)
  The type of the taskable. Available options: client, case, plan
- **taskable** (object)
  The type of the taskable.
- **author** (object)
  The account that created the task
- **assigned_to** (object)
  The accounts that the task is assigned to
- **completed_at** (string)
  The date the task was completed
- **completed_by** (object)
  The account that completed the task
- **custom_fields** (array[object])
  Any custom fields on the model.


[Powered by Bump.sh](https://bump.sh)