Skip to main content
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

Missing title, 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 the crm: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 description if your workflow needs the association.
  • due_at is stored as an instant, not a calendar day. Send an explicit timezone offset (or Z) so a due date does not shift for users in America/Santiago.

Authorizations

Authorization
string
header
required

Personal Access Token con prefijo kbai_pk_. Generar desde el portal con permiso developer.manage_tokens.

Body

application/json
title
string
required

Título de la tarea

assigned_to
string

Id del usuario asignado

status
string
default:pending

Estado libre. Los valores del portal son pending, in_progress, completed y cancelled.

priority
enum<string>
default:medium
Available options:
low,
medium,
high,
urgent
due_at
string

Vencimiento en ISO 8601

description
string

Response

201 - application/json
task
object
required