NEnex
Tasks

Create a task

Changed on

Creates a new task, optionally associated with records and assignees

post/v1/tasks

Request

  • Base URL
    https://app.nex.ai/api/developers
  • Auth
    API key in header Authorization

Request body

titlestring required

Task title (non-empty)

descriptionstring

Task description

priority'unspecified' | 'low' | 'medium' | 'high' | 'urgent'

Task priority

due_datestring date-time

Due date (RFC3339)

entity_idsstring[]

Associated record IDs

assignee_idsstring[]

Assigned user IDs

Example request

{
  "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"
  ]
}

Response

Created task

idstring
titlestring
descriptionstring
prioritystring
due_datestring date-time
is_completedboolean
completed_atstring date-time
assignee_idsstring[]
entity_idsstring[]
created_bystring
created_by_idstring
created_atstring date-time
archived_atstring date-time

Example response

{
  "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"
}

Changes