Skip to main content
POST
/
v1
/
tasks
Create a task
curl --request POST \
  --url https://app.nex.ai/api/developers/v1/tasks \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Follow up with client",
  "description": "Discuss contract renewal",
  "priority": "high",
  "due_date": "2026-03-01T09:00:00Z",
  "entity_ids": [
    "1001",
    "1002"
  ],
  "assignee_ids": [
    "50"
  ]
}
'
{
  "id": "800",
  "title": "Follow up with client",
  "description": "Discuss contract renewal",
  "priority": "high",
  "due_date": "2026-03-01T09:00:00Z",
  "is_completed": false,
  "assignee_ids": [
    "50"
  ],
  "entity_ids": [
    "1001",
    "1002"
  ],
  "created_by": "developer_api",
  "created_by_id": "42",
  "created_at": "2024-01-15T10:00:00Z"
}

Authorizations

Authorization
string
header
required

API key for authentication (format: "Bearer YOUR_API_KEY")

Body

application/json

Task to create

title
string
required

Task title (non-empty)

description
string

Task description

priority
enum<string>

Task priority

Available options:
unspecified,
low,
medium,
high,
urgent
due_date
string<date-time>

Due date (RFC3339)

entity_ids
string[]

Associated record IDs

assignee_ids
string[]

Assigned user IDs

Response

Created task

id
string
title
string
description
string
priority
string
due_date
string<date-time>
is_completed
boolean
completed_at
string<date-time>
assignee_ids
string[]
entity_ids
string[]
created_by
string
created_by_id
string
created_at
string<date-time>
archived_at
string<date-time>
Last modified on March 7, 2026