Sign in

v1

latestOpenAPI 3.0.32026-07-26870417.2 KB
tasks

Create Task

This endpoint creates a new task

post/tasks/create

Request body

titlestring required
  • The title of the task (1–500 characters)
type'todo' | 'chat' | 'message' | 'ticket'
  • The type of the new task
  • Possible values: todo, chat, message, ticket
  • Default todo
status'open' | 'inprogress' | 'closed'
  • Status of the task
  • Possible values: open, inprogress, closed
  • Default open
priority1 | 2 | 3
  • The priority of the new task
  • Possible values: 1, 2, 3
  • Default 1
assigneestring
  • Email of an org member. Validated against your org's member list
due_datestring
  • The due date of the new task
  • Should be in ISO 8601 timestamp format
notesstring
  • Free-form text attached to the task
remind_atstring
  • The remind date for the task to receive a reminder
  • Should be in ISO 8601 timestamp format
created_bystring
  • Email of an org member. Defaults to "api"

Example request

{
  "title": "Example todo task title",
  "type": "todo",
  "association": {
    "chat_id": "919205202401@c.us",
    "message_id": "true_4ca42ab6-77a9-428d-b614-5eb37bcf8f95_anjali.pandey@hashlabs.dev",
    "ticket_id": "BKT-001"
  },
  "status": "open",
  "priority": 2,
  "assignee": "ankit.singh@hashlabs.dev",
  "due_date": "2026-06-15T18:00:00+00:00",
  "notes": "Customer escalated via email — coordinate with support",
  "remind_at": "2026-06-18T18:00:00+00:00",
  "created_by": "anjali.pandey@hashlabs.dev"
}

Response

200 OK

object required

The response is a task object. Refer to the task object here