Sign in
latestOpenAPI 3.0.32026-08-22149327338.9 KB

d4db007b26b2

import

Import a task

Imports a task with its original timestamps. Unlike POST /tasks, this does not fire triggers, notifications, realtime updates, or analytics, and it accepts created_at, updated_at, started_at and completed_at. Import projects before the tasks that belong to them.

Rate limit: 20 requests per minute

post/import/tasks

Request body

account_idstring

Account ID for this task.

assignee_idstring

Assignee ID for this task. May be a user or a contact.

body_htmlstring

Body HTML for this task.

completed_atstring

The time the task was completed, in RFC 3339 format. Must be empty when status is not started. format: date-time

created_atstring

The time the task was created in the system it is being imported from, in RFC 3339 format. Defaults to now. format: date-time

customer_portal_visibleboolean

Whether the task is visible in the customer portal. Defaults to false.

due_datestring

Due date for this task, in RFC 3339 format. format: date-time

milestone_idstring

Milestone ID for this task.

parent_task_idstring

Parent task ID, to import this task as a subtask.

project_idstring

Project ID for this task.

started_atstring

The time work started on the task, in RFC 3339 format. Must be empty when status is not started. format: date-time

statusstring

Status for this task. Accepts the default statuses or a custom status slug. Defaults to not_started.

titlestring required

Title for this task.

updated_atstring

The time the task was last updated in the system it is being imported from, in RFC 3339 format. Defaults to now. format: date-time

Response

request_idstring

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    }
  }
}