DESCRIPTION

This endpoint creates a new task for the specified matter.

URL STRUCTURE

https://[hostname]/task/new

METHOD

POST

HEADERS

**Authorization:**    string Base64       [email]:[key]

PARAMETERS

NameTypeDescription
matterintRequired. Internal ID of matter that the task should be created for.
due-datestringRequired. Date the task should be completed by.
descriptionstringRequired. Title/description of task.
userint|stringID of user or their exact username.
importanceint|stringID or exact name of a task importance in the system.
typeint|stringID or exact name of a task type in the system.
templateintInternal ID of correspondence template to be associated with the task.
custom-fieldsarrayJSON array of custom fields.
Example:
{
  "621": "Mechanised Suit"
}
        


RETURNS

Returns the new task.

[
 {
      "parentTask": null,
      "id": "355",
      "description": "DG to check incoming item for docketing\t",
      "doneDate": {
          "date": "2019-12-10 16:14:01.000000",
          "timezone_type": 3,
          "timezone": "Europe/London"
      },
      "matterId": "66",
      "matterCode": "000015GB",
      "clientId": null,
      "client": "Seraphis Guitars",
      "presetItemId": "460",
      "dueDate": {
          "date": "1970-01-11 00:00:00.000000",
          "timezone_type": 3,
          "timezone": "Europe/London"
      },
      "status": "0",
      "statusName": "Live",
      "importance": "2",
      "importanceName": "Fatal",
      "formallyExtended": "0",
      "user": {
          "id": null,
          "oldId": null,
          "subscriberId": null,
          "username": "",
          "email": null,
          "secondaryEmail": [],
          "firstName": null,
          "secondName": null,
          "subscriberRef": null,
          "clientSQL": null,
          "loginCount": null,
          "lastLogin": null,
          "notes": null,
          "gender": null,
          "initials": null,
          "legalEntity": null
      },
      "type": "0",
      "typeName": null,
      "notes": null,
      "parentTaskId": null,
      "components": null,
      "workFlowLogId": null,
      "attachedTemplate": "0",
      "setupDate": null,
      "linkedDocuments": null,
      "outgoingDiscarded": null,
      "recipientId": null,
      "deliveryMethodOverride": null,
      "workflowPromptId": null,
      "originalDueDate": null,
      "invoiceId": null
  }, ]