---
title: "Create a task"
method: POST
path: "/crm/tasks"
tags: ["Tasks"]
---

# Create a task

`POST /crm/tasks`

## Request body

- Body11
  - `name` string, required — Name of task
  - `duration` integer — Duration of task in milliseconds [1 minute = 60000 ms]
  - `taskTypeId` string, required — Id for type of task e.g Call / Email / Meeting etc.
  - `date` string, date-time, required — Task due date and time
  - `notes` string — Notes added to a task
  - `done` boolean — Task marked as done
  - `assignToId` string — To assign a task to a user you can use either the account email or ID.
  - `contactsIds` integer[] — Contact ids for contacts linked to this task
  - `dealsIds` string[] — Deal ids for deals a task is linked to
  - `companiesIds` string[] — Companies ids for companies a task is linked to
  - `reminder` TaskReminder — Task reminder date/time for a task
    - `value` integer, required — Value of time unit before reminder is to be sent
    - `unit` 'minutes' | 'hours' | 'weeks' | 'days', required — Unit of time before reminder is to be sent
    - `types` string[], required — Type of task reminder e.g email, push

## Response `201`

Created new task

- InlineResponse2012 — Task Details
  - `id` string, required — Unique task id

## Other responses

- `400` — Returned when invalid data posted

---

[API](https://skmtc.net/getbrevo/apis/brevo-api.md) · [All operations](https://skmtc.net/getbrevo/apis/brevo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbrevo/brevo-api/revisions/2aec3cf66501/schema)