Crear una tarea
Tasks
POST /v1/crm/tasks
Create a task with an optional assignee, due date, and priority.
POST
Crear una tarea
Creates a task. Only
title is mandatory.
The company is taken from your token and must not appear in the body. Sending it returns 400. Unlike customers, tickets, and notes, tasks carry no project — they are company-level records.
Endpoint
Required scope
crm:tasks:write
Headers
Body
Example request
Response
201 Created
400 Bad Request
Missingtitle, a due_at that is not valid ISO 8601, a priority outside the allowed set, or a property the endpoint does not accept — including company, which is derived from the token.
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have thecrm:tasks:write scope.
Operational notes
- Tasks stand alone. There is no field linking a task to a ticket or a customer. Put the related id in the
descriptionif your workflow needs the association. due_atis stored as an instant, not a calendar day. Send an explicit timezone offset (orZ) so a due date does not shift for users inAmerica/Santiago.
Authorizations
Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.
Body
application/json
Título de la tarea
Id del usuario asignado
Estado libre. Los valores del portal son pending, in_progress, completed y cancelled.
Available options:
low, medium, high, urgent Vencimiento en ISO 8601
Response
201 - application/json