CreateNewTask

Function to create new task

POST https://rest.crmango.com/api/CreateNewTask

Authorization1 Body data31 Response3 Example request

Authorization

1 Sent in the request headers

Bearer varchar

Auth token (required in Authorization header)

Body data

31 Sent in the request body

task_name varchar

Task name (required, max 255 chars). Characters ' " ; < > are removed

reporter_id integer

User ID who created the task. Unknown or blocked user = 0
Reference: GetAllUsers

assignee_id integer

User ID assigned to the task. Unknown or blocked user = 0
Reference: GetAllUsers

watcher_id varchar

Comma-separated IDs of users who watch the task (e.g. "3,7"). Only active users are saved
Reference: GetAllUsers

is_private integer

Private task (0 = public, 1 = private)

priority integer

Task priority (0 = lowest, 5 = highest)

company_id integer

ID of the related company from the address book. The company name is filled in automatically

task_type_id integer

Task type. Unknown type = 0
Reference: GetAllLists

label_id varchar

Comma-separated label IDs assigned to the task (e.g. "4" or "4,6"). If any label does not exist, no label is saved

status integer

Task status (default 1). Status 2 = done: the task is saved as completed (progress 100, completion time set)
Reference: GetAllLists

progress integer

Task completion percentage (0–100). 100 = done: the task is saved as completed (status 2, completion time set)

creation_date date

Creation date of the task (Y-m-d). A date in the past is replaced with the current time

description varchar

Task description (auto-encoded to base64 if not already). Characters ' " ; < > are removed

is_description_base64 integer

1 = already base64 encoded, 0 = will be encoded server-side

task_deadline_date date

Task deadline (Y-m-d or Y-m-d H:i). A date in the past is ignored (no deadline)

planned_start date

Planned start (Y-m-d H:i)

planned_end date

Planned end (Y-m-d H:i). Must be after planned_start, otherwise it is ignored

order_id integer

Linked order ID. Unknown order is ignored

required_act_type_id integer

Required activity type (optional)

act_id integer

Activity ID (optional)

recurring_task_id integer

ID of the recurring task template. Task type, days_before, repeat_after, repeat_after_km, km_before, tachometer_status and deadline are taken from the template unless you send them
Reference: GetAllLists

days_before integer

How many days before the deadline to notify (default 5)

repeat_after integer

How many days after completion to repeat the task (0–5000, 0 = no repeat)

repeat_after_km integer

Repeat after this many kilometers (vehicles, default 0)

km_before integer

How many kilometers before the due tachometer status to notify (default 5000)

tachometer_status integer

Tachometer status at which the task is due (default 0)

vehicle_id integer

ID of the related vehicle. Unknown or deleted vehicle is ignored

trailer_id integer

ID of the related trailer (vehicle from the vehicle list). Unknown or deleted trailer is ignored

driver_id integer

ID of the driver (contact of the driver type from the address book). Other contacts are ignored

register_id integer

ID of the related register record. Saved only together with register_type_id

register_type_id integer

ID of the register type. Saved only together with register_id

Response

3 HTTP 201

Function to create new task

code integer

HTTP status code (201 = Created)

message varchar

Confirmation message

resource_id integer

ID of the newly created task

Example request

curl --request POST \
  --url 'https://rest.crmango.com/api/CreateNewTask' \
  --header 'Authorization: Bearer auth_token' \
  --header 'Content-Type: application/json' \
  --data '{
    {
        "task_name": "Service the truck",
        "reporter_id": 5,
        "assignee_id": 12,
        "watcher_id": "3,7",
        "is_private": 0,
        "priority": 3,
        "company_id": 8,
        "task_type_id": 2,
        "label_id": "4,6",
        "status": 1,
        "progress": 10,
        "creation_date": "2026-10-18",
        "description": "Negotiate cooperation terms",
        "is_description_base64": 0,
        "task_deadline_date": "2026-11-30 12:00",
        "planned_start": "2026-11-25 08:00",
        "planned_end": "2026-11-25 16:00",
        "order_id": 102,
        "recurring_task_id": 3,
        "days_before": 5,
        "repeat_after": 30,
        "repeat_after_km": 15000,
        "km_before": 1000,
        "tachometer_status": 250000,
        "vehicle_id": 14,
        "trailer_id": 15,
        "driver_id": 77
    }
  }'

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://rest.crmango.com/api/CreateNewTask',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    {
        "task_name": "Service the truck",
        "reporter_id": 5,
        "assignee_id": 12,
        "watcher_id": "3,7",
        "is_private": 0,
        "priority": 3,
        "company_id": 8,
        "task_type_id": 2,
        "label_id": "4,6",
        "status": 1,
        "progress": 10,
        "creation_date": "2026-10-18",
        "description": "Negotiate cooperation terms",
        "is_description_base64": 0,
        "task_deadline_date": "2026-11-30 12:00",
        "planned_start": "2026-11-25 08:00",
        "planned_end": "2026-11-25 16:00",
        "order_id": 102,
        "recurring_task_id": 3,
        "days_before": 5,
        "repeat_after": 30,
        "repeat_after_km": 15000,
        "km_before": 1000,
        "tachometer_status": 250000,
        "vehicle_id": 14,
        "trailer_id": 15,
        "driver_id": 77
    }
  }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer auth_token',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

echo $response;

var data = JSON.stringify({
  {
      "task_name": "Service the truck",
      "reporter_id": 5,
      "assignee_id": 12,
      "watcher_id": "3,7",
      "is_private": 0,
      "priority": 3,
      "company_id": 8,
      "task_type_id": 2,
      "label_id": "4,6",
      "status": 1,
      "progress": 10,
      "creation_date": "2026-10-18",
      "description": "Negotiate cooperation terms",
      "is_description_base64": 0,
      "task_deadline_date": "2026-11-30 12:00",
      "planned_start": "2026-11-25 08:00",
      "planned_end": "2026-11-25 16:00",
      "order_id": 102,
      "recurring_task_id": 3,
      "days_before": 5,
      "repeat_after": 30,
      "repeat_after_km": 15000,
      "km_before": 1000,
      "tachometer_status": 250000,
      "vehicle_id": 14,
      "trailer_id": 15,
      "driver_id": 77
  }
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "https://rest.crmango.com/api/CreateNewTask");
xhr.setRequestHeader("Authorization", "Bearer auth_token");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

import requests
import json

url = "https://rest.crmango.com/api/CreateNewTask"

payload = json.dumps({
  {
      "task_name": "Service the truck",
      "reporter_id": 5,
      "assignee_id": 12,
      "watcher_id": "3,7",
      "is_private": 0,
      "priority": 3,
      "company_id": 8,
      "task_type_id": 2,
      "label_id": "4,6",
      "status": 1,
      "progress": 10,
      "creation_date": "2026-10-18",
      "description": "Negotiate cooperation terms",
      "is_description_base64": 0,
      "task_deadline_date": "2026-11-30 12:00",
      "planned_start": "2026-11-25 08:00",
      "planned_end": "2026-11-25 16:00",
      "order_id": 102,
      "recurring_task_id": 3,
      "days_before": 5,
      "repeat_after": 30,
      "repeat_after_km": 15000,
      "km_before": 1000,
      "tachometer_status": 250000,
      "vehicle_id": 14,
      "trailer_id": 15,
      "driver_id": 77
  }
})
headers = {
  'Authorization': 'Bearer auth_token',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

{
    "code": 201,
    "message": "Task was created",
    "resource_id": 1234
}

{
    "code": "int",
    "message": "string"
}