Метод для создания нового напоминания.
При создании напоминания обязательным условием является указания типа напоминания: звонок, встреча, простое напоминание, событие или письмо. При этом не требуется дополнительное описание - вы просто создадите напоминание с соответствующим текстом. Если вы укажите описание напоминания - то именно оно и станет текстом напоминания.
У напоминания должны быть ответственные, если их не указывать - ответственным назначаетесь вы.
Ответственным для напоминания без привязки к каким-либо сущностям может стать любой сотрудник компании. Актуальный состав сотрудников компании вы можете получить в методе список сотрудников.
| 
                
                  
                
                
                  Запрос
                
               | |||
|---|---|---|---|
| task | object* | Собранный объект параметров создаваемого напоминания | |
| kind | string* | Тип: call (позвонить контакту), meeting (встреча), reminder (простое напоминание), event (событие), email (написать письмо) | |
| content | string | Описание (по умолчанию - название типа) | |
| due_at | string | Срок выполнения напоминания (ISO-8601) в формате YYYY-MM-DDThh:mm:ss.sssTZD. Если указано время 23:59:59.000, то напоминание будет создано на весь день (без указания времени). | |
| priority | integer | Приоритет: 1 (по умолчанию), 2 (важно) или 3 (очень важно). | |
| performer_ids | array of integers | Массив идентификаторов пользователей, привязываемых к напоминанию как «ответственные» (по умолчанию ответственным назначаетесь вы) | |
| custom_properties | array of objects | Задаваемые дополнительные поля | |
| id | integer | Идентификатор поля | |
| value | string | Устанавливаемое значение | |
| 
                
                  
                
                
                  Ответ
                
               | |||
| data | object | Созданное напоминание | |
| id | integer | Идентификатор созданного напоминания | |
| kind | string | Тип | |
| content | string | Описание | |
| due_at | string | Срок выполнения напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
| priority | integer | Приоритет | |
| user_id | integer | Идентификатор пользователя-создателя напоминания | |
| status | string | Статус напоминания (активная - undone) | |
| created_at | string | Дата и время создания напоминания (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ | |
| performer_ids | array of integers | Массив идентификаторов пользователей, привязанных к напоминанию как «ответственные» | |
| custom_properties | array of objects | Дополнительные поля напоминания | |
| id | integer | Идентификатор поля | |
| name | string | Название поля | |
| data_type | string | Тип поля (string, number, date или link) | |
| value | string | Значение | |
| 
                
                  
                
                
                  Возможные ошибки запроса (errors code)
                
               | |||
| blank | Поле не может быть пустым | ||
| too_long | Поле не может содержать более 65535 символов | ||
| inclusion | Поле имеет непредусмотренное значение | ||
| invalid | Поле имеет неверное значение (например, указаны недопустимые ответственные) | ||
| 
 | |||
{
  "task": {
    "kind": "reminder",
    "content": "Забрать со склада 21 заказ",
    "due_at": "2020-06-05T12:00:00.000+0300",
    "priority": 2,
    "custom_properties": [
      {
        "id": 78,
        "value": "Синий склад"
      }
    ]
  }
}{
  "data": {
    "id": 22283,
    "kind": "reminder",
    "content": "Забрать со склада 21 заказ",
    "due_at": "2020-06-05T09:00:00.000Z",
    "priority": 2,
    "user_id": 12,
    "status": "undone",
    "created_at": "2020-06-04T10:37:57.000Z",
    "performer_ids": [
      12
    ],
    "custom_properties": [
      {
        "id": 78,
        "name": "Место",
        "data_type": "string",
        "value": "Синий склад"
      }
    ]
  }
}