Skip to main content
Node.js

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
title
string
required
  • The title of the task (1–500 characters)
Example:

"Example todo task title"

type
enum<string>
default:todo
  • The type of the new task
  • Possible values: todo, chat, message, ticket
  • Default todo
Available options:
todo,
chat,
message,
ticket
Example:

"todo"

association
object
  • Required when type !== "todo". Forbidden when type === "todo".
  • Must contain exactly one of chat_id / message_id / ticket_id, matching the type
status
enum<string>
default:open
  • Status of the task
  • Possible values: open, inprogress, closed
  • Default open
Available options:
open,
inprogress,
closed
Example:

"open"

priority
enum<number>
default:1
  • The priority of the new task
  • Possible values: 1, 2, 3
  • Default 1
Available options:
1,
2,
3
Example:

2

assignee
string
  • Email of an org member. Validated against your org's member list
Example:

"ankit.singh@hashlabs.dev"

due_date
string
  • The due date of the new task
  • Should be in ISO 8601 timestamp format
Example:

"2026-06-15T18:00:00+00:00"

notes
string
  • Free-form text attached to the task
Example:

"Customer escalated via email — coordinate with support"

remind_at
string
  • The remind date for the task to receive a reminder
  • Should be in ISO 8601 timestamp format
Example:

"2026-06-18T18:00:00+00:00"

created_by
string
  • Email of an org member. Defaults to "api"
Example:

"anjali.pandey@hashlabs.dev"

Response

200 - application/json

200 OK

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