> ## Documentation Index
> Fetch the complete documentation index at: https://collabase.ch/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Collabase documentation. Interface labels are quoted in English, as they appear in the product.
> Features marked Enterprise need the Collabase Enterprise Edition licence.

# Create CRM task

> Create a task on one or more records, with an optional due day and assignees; a repeated call with the same id finds the task.

Creates a task in the CRM. It belongs to the records in `targetIds`, not to a project or a Space. The
people in `assigneeIds` are told as in the app.

> [!NOTE]
>
> Scope `crm:write`. The token owner needs the right to create tasks and to read every record the task is on.

## Request body

**title** `string` *required*

Up to 300 characters.

**description** `string`

Plain text, up to 20,000 characters.

**dueDate** `string | null`

A calendar day as `YYYY-MM-DD`.

**status** `string` (default: TODO)

`TODO`, `IN_PROGRESS` or `DONE`.

**assigneeIds** `array` (default: \[])

People, at most 50.

**targetIds** `array` *required*

The records the task is on, 1 to 20.

**id** `string`

An id you choose (8 to 64 letters, digits, `_` or `-`). A repeated call with the same id returns the task it already made.

## Response

The created task, with status `201`.

```bash cURL theme={"dark"}
curl -X POST "https://your-collabase.ch/api/v1/crm/tasks" \
  -H "Authorization: Bearer cb_xYz123ABCD..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Send the offer",
    "dueDate": "2026-12-01",
    "targetIds": ["cm3rec0001"]
  }'
```

```json 201 theme={"dark"}
{ "data": { "id": "cm3task001", "title": "Send the offer", "status": "TODO", "dueDate": "2026-12-01" } }
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.